Get Open Orders

Get all open (not filled or canceled) orders for a user by specified parameters.

Request

Method:

GET ./api/v2/openbook/open-orders/{market}

Parameters:

Parameter	Type	Description
market	string	Smart contract address/symbol of the market.
address	string	OPTIONAL. Trading account address to be fetched. Leave blank for all accounts.
openOrdersAddress	string	OPTIONAL. Open orders address to be fetched.
contracts	string	OPTIONAL. Specify which future contract to fetch position details. Ex. "SOL_PERP". Default "ALL"
limit	number	OPTIONAL. The maximum number of orders to fetch. Use "0" for no limits. Default "0".

Note that only one of address or openOrdersAddress should be specified. If you specify an address, all open orders addresses associated with your address and the specified market will be fetched, which can be a time-consuming lookup.

Request example:

HTTP

curl --header "Authorization: $AUTH_HEADER" \
'https://ny.solana.dex.blxrbdn.com/api/v2/openbook/open-orders/SOLUSDC?address=AFT8VayE7qr8MoQsW3wHsDS83HhEvhGWdbNSHRKeUDfQ'

WebSocket

wscat --header "Authorization: $AUTH_HEADER"
-c wss://ny.solana.dex.blxrbdn.com/ws --wait 30 --execute '{"jsonrpc": "2.0", "id": 1, "method": "GetOpenOrders", "params": {"market": "SOLUSDC", "address": "AFT8VayE7qr8MoQsW3wHsDS83HhEvhGWdbNSHRKeUDfQ"}}'

Go

//Make sure to set environment variable AUTH_HEADER.
openOrders, err := g.GetOpenOrders(context.Background(), "ETH/USDT", "4raJjCwLLqw8TciQXYruDEF4YhDkGwoEnwnAdwJSjcgv", "") 

Python

#Make sure to set environment variable AUTH_HEADER.
await api.get_open_orders(market="SOLUSDC", address=PUBLIC_KEY)

TypeScript

await provider.getOpenOrders({
    market: "SOLUSDC",
    address: ownerAddress,
    limit: 0,
    openOrdersAddress: "",
})

Response:

Fields:

Parameter	Description
orders	See Orders below.
project	Name of the DEX project.

Orders:

Field	Description
orderID	Unique order ID
market	Market of the order.
side	Side of order: “BID” or “ASK”
types	Types of order, “LIMIT”, "IOC", "POSTONLY"
price	The price of the order.
size	Original size of the order.
remainingSize	Size of order not yet filled.
createdAt	Timestamp when the fill was created.
status	Order status

Example:

JSON

{
  "project": "P_SERUM",
  "orders": [
    {
      "orderID": "3121926967034604515578797042",
      "market": "SOL/USDC",
      "side": "S_ASK",
      "types": [
        "OT_LIMIT"
      ],
      "price": 169240,
      "size": 0.1,
      "remainingSize": 0.1,
      "createdAt": null,
      "status": "OS_PARTIAL_FILL"
    },
    {
      "orderID": "3121926967034604515580964513",
      "market": "SOL/USDC",
      "side": "S_ASK",
      "types": [
        "OT_LIMIT"
      ],
      "price": 169240,
      "size": 0.1,
      "remainingSize": 0.1,
      "createdAt": null,
      "status": "OS_PARTIAL_FILL"
    },
    ...
  ]
}