Skip to main content
GET
/
v1
/
perps
/
orders
Get Orders
curl --request GET \
  --url https://api.ondoperps.xyz/v1/perps/orders \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "result": [
    {
      "orderId": "197ec08e001658690721be129e7fa595",
      "side": "buy",
      "price": "227.50",
      "size": "10.00",
      "market": "AAPL-USD.P",
      "filledSize": "5.00",
      "lastFillSize": "2.50",
      "filledCost": "1137.50",
      "fee": "0.57",
      "status": "open",
      "createdAt": "2025-03-05T14:30:00Z",
      "type": "limit",
      "timeInForce": "GTC",
      "reduceOnly": false
    }
  ],
  "pageInfo": {
    "nextCursor": "NQ5WWO3THN3Q====",
    "prevCursor": "O4ZTGM3RGM2DG==="
  }
}

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer

Maximum number of results to return

Example:

1000

cursor
string

Pagination cursor

Example:

"NQ5WWO3THN3Q===="

market
string

Filter by trading market

Example:

"AAPL-USD.P"

status
enum<string>

Filter by order status

Available options:
open,
canceled,
fullyfilled
Example:

"open"

startTime
integer

Filter orders placed at or after this time (UTC milliseconds)

Example:

1684814400000

endTime
integer

Filter orders placed at or before this time (UTC milliseconds)

Example:

1672549200000

Response

Paginated list of orders, reverse chronological

success
boolean
required

Whether the request was successful

Example:

true

error
string

Error message, present only on failure

Example:

""

error_code
string

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecated
string

Deprecation notice, if applicable

Example:

""

result
object[]
pageInfo
object