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

Block trade status filter

marketstring

Market symbol filter, ex: BTC-USD-PERP

Response

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 9 of the 65 revisions of this API.183517

Jul 22, 202648fe202ea88822See the full diff
- ●
  added the new UNWIND_TRANSFER enum value to the ////////////// response property for the response status
  response-property-enum-value-added
- ●
  added the new UNWIND_TRANSFER enum value to the ////////////// response property for the response status
  response-property-enum-value-added
- ○
  removed the TRANSFER enum value from the ////////////// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSFER enum value from the ////////////// response property for the response status
  response-property-enum-value-removed
Jul 17, 2026f1370c46e9e83See the full diff
- ●
  added the new BLOCK_TRADE_REPLAYED_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_VAULT_OPERATORS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new VAULT_DATA_PRIVATE enum value to the //// response property for the response status
  response-property-enum-value-added
Jun 9, 202643b81de9b0793See the full diff
- ○
  removed the INVALID_RHINOFI_QUOTE enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_QUOTE_COMMIT enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RHINOFI_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
May 21, 20267861dbd35cf52See the full diff
- ●
  added the new IP_NOT_ALLOWED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MARKET_NOT_SETTLED enum value to the //// response property for the response status
  response-property-enum-value-added
May 7, 2026d24c9b025e4b21See the full diff
- ●
  added the new BLOCK_TRADE_INVALID_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_SIGNER_KEY_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
May 4, 20266540e7a44a834See the full diff
- ●
  added the new EVM_ADDRESS_ALREADY_ONBOARDED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INSUFFICIENT_EVM_BALANCE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_INVALID_ACCOUNT_KIND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_ONBOARDING_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
Apr 29, 2026b83876e772af3See the full diff
- ○
  removed the BAD_STARKNET_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PRICE_PRECISION enum value from the //// response property for the response status
  response-property-enum-value-removed
- ○
  removed the TRANSACTION_NOT_FOUND enum value from the //// response property for the response status
  response-property-enum-value-removed
Apr 22, 202646a57608a79018226See the full diff
- ▲
  the /// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the /// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ///// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ///// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ///// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ///// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ////////// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the ///// response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ●
  added the new BLOCK_TRADE_ACCOUNT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_EXPIRED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_SIGNERS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_MISSING_TRADES enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_ENABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new BLOCK_TRADE_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new EVM_SIGNATURE_VERIFICATION_FAILED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new INVALID_EVM_SIGNATURE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new MEDIA_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_ALREADY_CANCELLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_INVALID_STATUS enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_MISMATCH enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_PARENT_NOT_ACCEPTING enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new OFFER_UNAUTHORIZED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new PENDING_SETTLEMENT enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new PORTFOLIO_MARGIN_CONFIG_NOT_FOUND enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new SUBKEY_NOT_ACTIVATABLE enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new XP_TRANSFERS_DISABLED enum value to the //// response property for the response status
  response-property-enum-value-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////////// to the response with the status
  response-optional-property-added
- ○
  removed the INVALID_JOIN_WAITLIST_REQUEST enum value from the //// response property for the response status
  response-property-enum-value-removed
Dec 24, 2025846a2e2b455b2See the full diff
- ○
  added the media type application/json for the response with the status
  response-media-type-added
- ○
  added the media type application/json for the response with the status
  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

Full history