Sign in
BlockTrades

List block trades

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

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

Changed in 1 of the 50 revisions of this API.2

  • e0dd7ef9404f2See the full diff
    • ○

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

      response-media-type-added

    • ○

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

      response-media-type-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog