Post Requests (Queries)

Query orders by price range without subscribing to full book.

Request Format

{
  "method": "post",
  "id": 123,
  "request": {
    "type": "info",
    "payload": {
      "type": "l4Orders",
      "coin": "BTC",
      "pxMin": "35000",
      "pxMax": "37000"
    }
  }
}

Payload Types

Type	Description
`l4Orders`	Query L4 orders in price range
`l3Orders`	Query L3 orders in price range

Payload Fields

Field	Type	Description
`type`	`"l4Orders"` \| `"l3Orders"`	Query type
`coin`	string	Trading pair
`pxMin`	string	Minimum price (inclusive)
`pxMax`	string	Maximum price (inclusive)

Response

{
  "channel": "post",
  "data": {
    "id": 123,
    "response": {
      "type": "info",
      "payload": {
        "type": "l4Orders",
        "data": {
          "coin": "BTC",
          "time": 1699900000000,
          "orders": [
            [/* bids */],
            [/* asks */]
          ]
        }
      }
    }
  }
}

Response Fields

Field	Type	Description
`id`	number	Request ID (echoed from request)
`response.type`	string	Response type (`"info"`)
`response.payload.type`	string	Query type
`response.payload.data.coin`	string	Trading pair
`response.payload.data.time`	number	Timestamp
`response.payload.data.orders`	array	`[bids, asks]` arrays

Example: Query L3 Orders

Request:

{
  "method": "post",
  "id": 1,
  "request": {
    "type": "info",
    "payload": {
      "type": "l3Orders",
      "coin": "ETH",
      "pxMin": "3400",
      "pxMax": "3600"
    }
  }
}

Response:

{
  "channel": "post",
  "data": {
    "id": 1,
    "response": {
      "type": "info",
      "payload": {
        "type": "l3Orders",
        "data": {
          "coin": "ETH",
          "time": 1699900000000,
          "orders": [
            [
              {"user": "0x...", "coin": "ETH", "side": "B", "limitPx": "3500.0", "sz": "1.0", "oid": 123, "timestamp": 1699899000000}
            ],
            [
              {"user": "0x...", "coin": "ETH", "side": "A", "limitPx": "3550.0", "sz": "2.0", "oid": 456, "timestamp": 1699899500000}
            ]
          ]
        }
      }
    }
  }
}