Skip to main content
GET
/
api
/
v1
/
open-orders
Get Account Open Orders
curl --request GET \
  --url https://user-account.trade.rails.xyz/api/v1/open-orders \
  --header 'Authorization: Bearer <token>'
{
  "openOrders": [
    {
      "market": "BTC-USD",
      "orderId": "01HZ36SYBP4Z80GRX30P49XHB6",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "65000",
      "quantity": "0.5",
      "filledQuantity": "0.5",
      "leverage": "1",
      "createdAt": 1717020981622,
      "updatedAt": 1717020982756,
      "orderStatus": "active",
      "clientRequestId": "0835bf3e-4a20-41f0-908d-8213f2b7a285",
      "postOnly": false,
      "avgFillPrice": "65000"
    },
    {
      "market": "ETH-USD",
      "orderId": "01HZ36SYBP4Z80GRX30P49XHB5",
      "orderType": "sell",
      "tradeType": "limit",
      "price": "3772.272138",
      "quantity": "1",
      "filledQuantity": "0.5",
      "leverage": "1",
      "createdAt": 1717020981622,
      "updatedAt": 1717020982756,
      "orderStatus": "active",
      "clientRequestId": "0835bf3e-4a20-41f0-908d-8213f2b7a285",
      "postOnly": false,
      "avgFillPrice": "3772.272138"
    }
  ],
  "last": "ETH-USD#01HYXJVRCTDXQSTKZ17ND2SBJH#c3029869-2609-4a0d-8d9b-b030550add28"
}

​
Order Quantity Fields

In the openOrders objects, quantity represents the remaining quantity and filledQuantity represents the cumulative filled quantity. The two values will add up to the original order quantity.

​
Order Statuses

This endpoint returns not only active orders but also orders with three intermediate statuses pending, cancelling, and modifying. All statuses are included in the response, allowing you to track orders that got stuck in these intermediate states. Note that only active orders make up your private order book for order matching.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
market
string

Example value: ETH-USD. To get all supported markets, call /api/v1/markets endpoint. Omit this parameter to get results across all markets.

​
start
string

This is an optional parameter to support pagination. Get the value from the last field if present in the previous response.

Response

200 - application/json
​
openOrders
object[]
​
last
string

This is an optional field in the response to support pagination. Use this value if present for the start parameter of the following request to get the next page of results.

⌘I