For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Join CommunityStart Trading
HomeOverviewTradingRisk & LiquidationsParadex ChainEcosystemREST APIWebSocket APIAgentic AI HubRelease Notes
HomeOverviewTradingRisk & LiquidationsParadex ChainEcosystemREST APIWebSocket APIAgentic AI HubRelease Notes
  • General Information
    • Server Location
    • Server URLs
    • Quick Start
    • Authentication
    • Rate Limits
    • Benchmarks
    • API Authentication
    • API Best Practices
  • Production API Reference
  • Testnet API Reference
        • GETGet open orders
        • POSTCreate order
        • DELCancel all open orders
        • GETGet orders
        • POSTCreate batch of orders
        • DELCancel batch of orders by order IDs
        • GETGet order by client id
        • DELCancel open order by client order id
        • GETGet order
        • PUTModify order
        • DELCancel order
  • Useful Resources
    • Paradex Github
    • Paradex CLI
    • Code Samples
    • Python SDK
    • CCXT Integration
Join CommunityStart Trading
Testnet API ReferenceOrders

Get orders

GET
https://api.testnet.paradex.trade/v1/orders-history
GET
/v1/orders-history
$curl -X GET https://api.testnet.paradex.trade/v1/orders-history \
>-H 'Accept: application/json' \
>-H 'Authorization: Bearer {JWT}'
1{
2  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
3  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
4  "results": [
5    {
6      "account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512x",
7      "avg_fill_price": "26000",
8      "cancel_reason": "NOT_ENOUGH_MARGIN",
9      "client_id": "x1234",
10      "created_at": 1681493746016,
11      "flags": [
12        "REDUCE_ONLY"
13      ],
14      "id": "123456",
15      "instruction": "GTC",
16      "last_updated_at": 1681493746016,
17      "market": "BTC-USD-PERP",
18      "price": "26000",
19      "published_at": 1681493746016,
20      "received_at": 1681493746016,
21      "remaining_size": "0",
22      "request_info": {
23        "id": "string",
24        "message": "string",
25        "request_type": "string",
26        "status": "string"
27      },
28      "seq_no": 1681471234972000000,
29      "side": "BUY",
30      "size": "0.05",
31      "status": "NEW",
32      "stp": "EXPIRE_MAKER",
33      "timestamp": 1681493746016,
34      "trigger_price": "26000",
35      "type": "MARKET"
36    }
37  ]
38}
Get current user orders filtered on attributes
Was this page helpful?
Previous

Create batch of orders

Next
Built with

Authentication

Authorizationstring
API Key authentication via header

Query parameters

client_idstringOptional
Unique ID of client generating the order
cursorstringOptional

Returns the ‘next’ paginated page.

end_atintegerOptional

End Time (unix time millisecond)

marketstringOptional
Market for the order
page_sizeintegerOptional1-5000Defaults to 100
Limit the number of responses in the page
sideenumOptional
Order side
Allowed values:
start_atintegerOptional

Start Time (unix time millisecond)

statusenumOptional
Order status
Allowed values:
typeenumOptional
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)

resultslist of objects
Array of paginated results

Errors

400
Bad Request Error