KAkairos
Perpetuals

Get a live perpetual market-data snapshot

Production beta, sourced directly from the selected venue by the Market Data API. Returns a canonical ordered book, recent trades, one-minute candles, funding observations, and typed market state. Financial values are exact decimal strings. Prices are direct venue prices, never 0–100 prediction probabilities. Quantities and volumes retain the declared base_asset or contracts unit. Do not derive notional for contract quantities without authoritative instrument metadata, and never apply the prediction-market / 100 formula. Each request costs 6 units in the HEAVY rate-limit bucket because it fans out to multiple venue resources. Responses are never cacheable by clients; the Market Data API uses a bounded one-second replica-local cache to coalesce bursts.

get/v1/perpetuals/{venue}/{instrument}/snapshot

Request

  • Base URL
    https://md.kairos.trade
  • Auth
    • none
    • or API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Path parameters

venue'hyperliquid' | 'polymarket_perps' | 'kalshi_margin' required
instrumentstring required

Venue-native instrument identifier, such as BTC, 6, or KXBTCPERP. Hyperliquid support is limited to standard main-dex perps in every environment; HIP-3 dex:coin identifiers are rejected. BTC and other standard listings are quoted in USDT, while HYPE and PURR are USDC-quoted exceptions. All three collateralize and settle in USDC. Their canonical identities are hl-mainnet-btc-usdt, hl-mainnet-hype-usdc, and hl-mainnet-purr-usdc.

Query parameters

depthinteger

Requested book depth per side. When omitted the default is the venue's own ceiling — 20 for hyperliquid (its l2Book returns no more), 500 for polymarket_perps and kalshi_margin. A value outside [1, 500], or one that is not an integer, is rejected with 400.

Response

Live canonical venue snapshot.

venue'hyperliquid' | 'polymarket_perps' | 'kalshi_margin' required
environmentstring required

Venue environment for this source identity.

integration_idstring required

Kairos integration and routing identity.

canonical_instrument_idstring required

Stable Kairos perpetual instrument identity.

venue_instrument_idstring required

Exact venue-native instrument identifier.

source'venue_public_api' required
fetched_at_nsinteger required

Kairos fetch completion time in Unix nanoseconds.

Example response

{
  "instrument_context": {
    "contract_multiplier": "0.001"
  },
  "book": {
    "bids": [
      {
        "price": "0.001",
        "quantity": "0.001"
      }
    ],
    "asks": [
      {
        "price": "0.001",
        "quantity": "0.001"
      }
    ]
  },
  "market_state": {
    "prices": [
      {
        "value": "0.001"
      }
    ],
    "measures": [
      {
        "value": "0"
      }
    ]
  },
  "trades": [
    {
      "price": "0.001",
      "quantity": "0.001"
    }
  ],
  "candles": [
    {
      "interval": "1m",
      "open": "0.001",
      "high": "0.001",
      "low": "0.001",
      "close": "0.001",
      "native_volume": "0"
    }
  ],
  "funding": [
    {
      "rate": "0",
      "funding_price": "0.001"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.