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
        • GETList block trades
        • POSTCreate block trade
        • GETGet block trade
        • DELCancel block trade
        • POSTExecute block trade
        • GETGet block trade offers
        • POSTCreate block trade offer
        • GETGet specific block trade offer
        • DELCancel block trade offer
        • POSTExecute individual offer
  • Useful Resources
    • Paradex Github
    • Paradex CLI
    • Code Samples
    • Python SDK
    • CCXT Integration
Join CommunityStart Trading
Testnet API ReferenceBlock Trades

Get block trade offers

GET
https://api.testnet.paradex.trade/v1/block-trades/:block_trade_id/offers
GET
/v1/block-trades/:block_trade_id/offers
$curl https://api.testnet.paradex.trade/v1/block-trades/block_trade_id/offers \
>     -H "Authorization: <apiKey>"
1{
2  "results": [
3    {
4      "block_expiration": 1640995800000,
5      "block_id": "block_456",
6      "block_type": "OFFER_BASED",
7      "created_at": 1640995200000,
8      "initiator": "0x123...abc",
9      "last_updated_at": 1640995400000,
10      "nonce": "67890",
11      "parent_block_id": "block_123",
12      "required_signers": [
13        "string"
14      ],
15      "signatures": {},
16      "status": "COMPLETED",
17      "trades": {}
18    }
19  ]
20}
Get all offers for a specific block trade. Returns all offers submitted for a parent block trade by required signers. **Access:** Available to initiator, required signers, or accounts with submitted offers. **Returns:** Array of offers with: - Offer ID and parent block trade reference - Offering account and trade details per market - Execution signatures and timestamps - Current offer state and execution details
Was this page helpful?
Previous

Create block trade offer

Next
Built with

Get all offers for a specific block trade.

Returns all offers submitted for a parent block trade by required signers.

Access: Available to initiator, required signers, or accounts with submitted offers.

Returns: Array of offers with:

  • Offer ID and parent block trade reference
  • Offering account and trade details per market
  • Execution signatures and timestamps
  • Current offer state and execution details

Authentication

Authorizationstring
API Key authentication via header

Path parameters

block_trade_idstringRequired
Parent Block Trade ID

Response

OK
resultslist of objects
Array of results

Errors

400
Bad Request Error
404
Not Found Error