Skip to main content
GET
/
orderbooks
Get live orderbooks for multiple markets
curl --request GET \
  --url https://api.agg.market/orderbooks \
  --header 'x-app-id: <api-key>'
{
  "data": [
    {
      "venueMarketId": "<string>",
      "status": "ok",
      "error": {
        "code": "market_not_found",
        "message": "<string>",
        "retryable": true
      },
      "requestedMarket": {
        "venueMarketId": "<string>",
        "venue": "kalshi",
        "marketStatus": "open",
        "tickSize": 123,
        "endDate": "<string>",
        "resolutionDate": "<string>"
      },
      "venueOrderbooks": {},
      "matchedMarkets": [
        {
          "venue": "kalshi",
          "venueMarketId": "<string>",
          "marketStatus": "open",
          "tickSize": 123,
          "hasOrderbook": true
        }
      ]
    }
  ],
  "meta": {
    "requestedCount": 1,
    "okCount": 1,
    "errorCount": 1
  }
}

Authorizations

x-app-id
string
header
required

Your application ID. Required for all app-tier and user-tier routes.

Query Parameters

venueMarketIds
required
Maximum array length: 20
depth
integer
Required range: 1 <= x <= 100

Response

200

data
object[]
required
meta
object
required