API reference / Orders

Open orders

Fetches all open orders for the user. Open orders are orders that are not yet filled, and can be cancelled.

View Markdown

GET https://api.bb.no/v1/orders

Authentication

API key

Send x-bb-api-key. No nonce or signature is required.

Authentication guide →

Parameters

No path or query parameters.

Responses

200 · OK

application/json

OpenOrdersResponse

Show fields

ordersarray of Order

Items:

Order

Show fields

orderIdstring

Example: "or_01J9ZK4T7M2QXW8B3N5R6V1Y0C"

typestring · enum

Values: ORDER_TYPE_MARKET, ORDER_TYPE_LIMIT

Example: "ORDER_TYPE_LIMIT"

directionstring · enum

Values: DIRECTION_BUY, DIRECTION_SELL

Example: "DIRECTION_BUY"

amountnumber · double

Example: 5000

createdAtstring · date-time

Example: "2026-03-14T09:26:53.589793Z"

Request example

GET/v1/ordersAPI key

curl -X GET \
  https://api.bb.no/v1/orders \
  -H "x-bb-api-key: $BB_API_KEY"

Replace example identifiers and set credentials in environment variables before running.

Response example

Response200

{
  "orders": [
    {
      "orderId": "or_01J9ZK4T7M2QXW8B3N5R6V1Y0C",
      "type": "ORDER_TYPE_LIMIT",
      "direction": "DIRECTION_BUY",
      "amount": 5000,
      "createdAt": "2026-03-14T09:26:53.589793Z"
    }
  ]
}