BlockTrades

List block trades

Changed on

Get a paginated list of block trades with filtering.

Returns block trades where user is initiator, required signer, or has submitted an offer.

Filters:

  • Status: CREATED, OFFER_COLLECTION, READY_TO_EXECUTE, EXECUTING, COMPLETED, CANCELLED
  • Market: Specific market symbol (e.g., BTC-USD-PERP)

Returns: Paginated list with block trade details and navigation metadata.

get/block-trades

Request

  • Base URL
    https://api.testnet.paradex.trade/v1
  • URL
    https://api.testnet.paradex.trade/v1/block-trades
  • Auth
    API key in header Authorization

Query parameters

status'CREATED' | 'OFFER_COLLECTION' | 'READY_TO_EXECUTE' | 'EXECUTING' | 'COMPLETED' | 'CANCELLED'

Block trade status filter

marketstring

Market symbol filter, ex: BTC-USD-PERP

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": [
    {
      "block_expiration": 1640995800000,
      "block_id": "block_456",
      "created_at": 1640995200000,
      "initiator": "0x123...abc",
      "last_updated_at": 1640995400000,
      "nonce": "67890",
      "parent_block_id": "block_123"
    }
  ]
}

Changes

  • e0dd7ef9404fRevision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status