Skip to main content
GET
/
v1
/
perps
/
orders
/
{orderID}
Get Order by ID
curl --request GET \
  --url https://api.ondoperps.xyz/v1/perps/orders/{orderID} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "result": {
    "orderId": "197ec08e001658690721be129e7fa595",
    "side": "buy",
    "price": "227.50",
    "size": "10.00",
    "market": "AAPL-USD.P",
    "filledSize": "10.00",
    "lastFillSize": "5.00",
    "filledCost": "2275.00",
    "fee": "1.14",
    "status": "fullyfilled",
    "createdAt": "2025-03-05T14:30:00Z",
    "filledAt": "2025-03-05T14:30:05Z",
    "type": "limit",
    "timeInForce": "GTC",
    "reduceOnly": false
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
orderID
string
required

Internal order ID, or client:{clientOrderID} for client order ID lookup

Example:

"197ec08e001658690721be129e7fa595"

Response

Order

​
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