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, EXECUTING, PENDING_SETTLEMENT, COMPLETED, FAILED, 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.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/block-trades
  • Auth
    API key in header Authorization

Query parameters

status'CREATED' | 'OFFER_COLLECTION' | 'EXECUTING' | 'PENDING_SETTLEMENT' | 'COMPLETED' | 'FAILED' | '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

  • 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

  • ed1654c95ef8Revision changes
    • breaking

      removed the enum value READY_TO_EXECUTE from the query request parameter status

    • info

      added the new enum value FAILED to the query request parameter status

    • info

      added the new enum value PENDING_SETTLEMENT to the query request parameter status

    • info

      removed the READY_TO_EXECUTE enum value from the /////// response property for the response status