List orders for account (filtered & paginated)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/tie-tech/hub/b2b-api/doc/broker-openapi/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "broker-openapi MCP server": {
    "url": "https://bump.sh/tie-tech/hub/b2b-api/doc/broker-openapi/mcp"
  }
}

Close
GET /trading/accounts/{account_id}/orders

Headers

  • PRE-ACCESS-KEY string Required

    Broker access key identifier.

    Format should match the following pattern: ^[A-Za-z0-9._~-]{1,64}$.

  • PRE-ACCESS-SIGNATURE string Required

    Keyed BLAKE2b-256 signature (hex lowercase, 64 characters).

    Format should match the following pattern: ^[0-9a-f]{64}$.

  • PRE-ACCESS-TIMESTAMP string(date-time) Required

    RFC3339 timestamp with milliseconds (e.g., 2025-10-30T06:00:34.075Z). Must be within clock_skew_tolerance (default 5m) of server time.

Path parameters

  • account_id string Required

    Broker-supplied account identifier; length 1..128; charset [A-Za-z0-9._~-].

    Maximum length is 128. Format should match the following pattern: ^[A-Za-z0-9._~-]{1,128}$.

Query parameters

  • market_id string Required
  • event_id string
  • status string

    Values are NEW, ACTIVE, PARTIALLY_FILLED, FILLED, CANCELLED, or EXPIRED.

  • limit integer

    Minimum value is 1, maximum value is 100. Default value is 50.

  • cursor string

    Opaque pagination cursor

Responses

  • 200 application/json

    Page of orders

    Hide response attributes Show response attributes object
    • items array[object] Required

      Current state of an order.

      Hide items attributes Show items attributes object

      Current state of an order.

      • order_id string(uuid) Required
      • client_order_id string Required
      • market_id string Required
      • broker_id string Required
      • account_id string Required
      • side string Required

        Values are BUY or SELL.

      • type string Required

        Values are LIMIT or MARKET.

      • tif string Required

        Values are GTC, IOC, FOK, or DAY.

      • token string Required

        Values are YES or NO.

      • price object Required
        Hide price attributes Show price attributes object
        • units integer(int64) Required
        • nanos integer(int32) Required

          Minimum value is -999999999, maximum value is 999999999.

      • qty object Required
        Hide qty attributes Show qty attributes object
        • units integer(int64) Required
        • nanos integer(int32) Required

          Minimum value is -999999999, maximum value is 999999999.

      • volume object Required
        Hide volume attributes Show volume attributes object
        • units integer(int64) Required
        • nanos integer(int32) Required

          Minimum value is -999999999, maximum value is 999999999.

      • filled_qty object Required
        Hide filled_qty attributes Show filled_qty attributes object
        • units integer(int64) Required
        • nanos integer(int32) Required

          Minimum value is -999999999, maximum value is 999999999.

      • filled_volume object Required
        Hide filled_volume attributes Show filled_volume attributes object
        • units integer(int64) Required
        • nanos integer(int32) Required

          Minimum value is -999999999, maximum value is 999999999.

      • filled_fee object

        Total filled fees accumulated on this order (in quote currency units).

        Hide filled_fee attributes Show filled_fee attributes object
        • units integer(int64) Required
        • nanos integer(int32) Required

          Minimum value is -999999999, maximum value is 999999999.

      • status string Required

        Values are NEW, ACTIVE, PARTIALLY_FILLED, FILLED, CANCELLED, EXPIRED, or REJECTED.

      • status_reason string

        Machine-readable reason code for the current status

        Values are USER_REQUEST, MARKET_CLOSED, MARKET_SETTLED, MARKET_VOIDED, TIF_EXPIRATION, FOK_FAILED, IOC_PARTIAL, SELF_TRADE_PREVENTION, INSUFFICIENT_FUNDS, SYSTEM_ERROR, ORDER_ALREADY_FILLED, ORDER_ALREADY_CANCELLED, ORDER_NOT_FOUND, QTY_INVALID, QTY_BELOW_EXECUTED, NO_MATCHING_LIQUIDITY, DUPLICATE_CLIENT_ORDER_ID, EXCEEDS_MAX_ORDER_QTY, EXCEEDS_MAX_ORDER_NOTIONAL, or EXCEEDS_MAX_POSITION.

      • last_update_wall_time_ns integer(int64) Required
      • last_update_engine_seq integer(int64) Required

        Monotonic engine sequence number of the last applied change

      • last_cmd_id_hex string

        32 lowercase hex

    • next_cursor string | null
  • 400 application/json

    Validation / semantic error

    Hide response attributes Show response attributes object
    • error_code string Required
    • message string Required
    • details object

      Additional properties are allowed.

  • 503 application/json

    Backpressure / temporary unavailability

    Hide response attributes Show response attributes object
    • error_code string Required
    • message string Required
    • details object

      Additional properties are allowed.

GET /trading/accounts/{account_id}/orders
curl \
 --request GET 'https://api.example.com/v1/trading/accounts/{account_id}/orders?market_id=string' \
 --header "PRE-ACCESS-KEY: string" \
 --header "PRE-ACCESS-SIGNATURE: string" \
 --header "PRE-ACCESS-TIMESTAMP: 2026-05-04T09:42:00Z"
Response examples (200)
{
  "items": [
    {
      "order_id": "string",
      "client_order_id": "string",
      "market_id": "string",
      "broker_id": "string",
      "account_id": "string",
      "side": "BUY",
      "type": "LIMIT",
      "tif": "GTC",
      "token": "YES",
      "price": {
        "units": 42,
        "nanos": 42
      },
      "qty": {
        "units": 42,
        "nanos": 42
      },
      "volume": {
        "units": 42,
        "nanos": 42
      },
      "filled_qty": {
        "units": 42,
        "nanos": 42
      },
      "filled_volume": {
        "units": 42,
        "nanos": 42
      },
      "filled_fee": {
        "units": 42,
        "nanos": 42
      },
      "status": "NEW",
      "status_reason": "USER_REQUEST",
      "last_update_wall_time_ns": 42,
      "last_update_engine_seq": 42,
      "last_cmd_id_hex": "string"
    }
  ],
  "next_cursor": "string"
}
Response examples (400)
{
  "error_code": "string",
  "message": "string",
  "details": {}
}
Response examples (503)
{
  "error_code": "string",
  "message": "string",
  "details": {}
}