Orders

Get orders

Changed on

Get current user orders filtered on attributes

get/orders-history

Request

  • Base URL
    https://api.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/orders-history
  • Auth
    API key in header Authorization

Query parameters

client_idstring

Unique ID of client generating the order

cursorstring

Returns the ‘next’ paginated page.

end_atinteger

End Time (unix time millisecond)

marketstring

Market for the order

page_sizeinteger

Limit the number of responses in the page

side'BUY' | 'SELL'

Order side

start_atinteger

Start Time (unix time millisecond)

status'OPEN' | 'CLOSED' | 'NEW'

Order status

type'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'STOP_LOSS_LIMIT' | 'STOP_LOSS_MARKET' | 'TAKE_PROFIT_LIMIT' | 'TAKE_PROFIT_MARKET'

Order type

Response

OK

nextstring

The pointer to fetch next set of records (null if there are no records left)

prevstring

The pointer to fetch previous set of records (null if there are no records left)

Example response

{
  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
  "results": [
    {
      "account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512x",
      "avg_fill_price": "26000",
      "cancel_reason": "NOT_ENOUGH_MARGIN",
      "client_id": "x1234",
      "created_at": 1681493746016,
      "id": "123456",
      "last_updated_at": 1681493746016,
      "market": "BTC-USD-PERP",
      "price": "26000",
      "published_at": 1681493746016,
      "received_at": 1681493746016,
      "remaining_size": "0",
      "seq_no": 1681471234972000000,
      "size": "0.05",
      "timestamp": 1681493746016,
      "trigger_price": "26000"
    }
  ]
}

Changes

  • f33feb7333eaRevision changes
    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

  • 72c125c93c2bRevision changes
    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status