KAkairos
Perpetuals

Discover perpetual instruments

Returns strict canonical instrument metadata, optionally for one venue. Financial values are exact decimal strings or null; consumers must not invent a contract multiplier, tick, or leverage value when one is absent. Results are cached independently per venue for 60 seconds.

This endpoint owns discovery and instrument rules only. Fetch live market state from the Market Data API's REST snapshot endpoint and real-time transport from websocket_cpp. This preview exists only in Kairos staging and returns 404 when disabled.

get/perpetuals/instruments

Request

  • Base URL
    https://staging-data.kairos.trade
  • Auth
    none required

Query parameters

venue'hyperliquid' | 'polymarket_perps' | 'kalshi_margin'

Canonical perpetual venue identifier.

Restrict discovery to one canonical venue.

Response

Canonical perpetual instrument records.

instrument_idstring required

Stable Kairos instrument identity. Hyperliquid standard assets use hl-mainnet-{base}-usdt; HYPE and PURR use the USDC exception.

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

Canonical perpetual venue identifier.

integration_idstring required

Product-specific routing and credential boundary.

environmentstring required
venue_instrument_idstring required

Exact identifier accepted by the venue and Market Data API snapshot endpoint.

display_symbolstring required
base_asset_idstring required
quote_asset_idstring required

Hyperliquid uses USDT except for HYPE and PURR, which use USDC.

collateral_asset_idstring required
settlement_asset_idstring nullable required
native_quantity_unit'base_asset' | 'contracts' required
contract_multiplierstring nullable required

Exact decimal string, or null when no authoritative conversion exists.

status'active' | 'inactive' | 'closed' | 'delisted' | 'unknown' required
isolated_onlyboolean nullable required

Null when the venue does not publish an authoritative mode.

max_leveragestring nullable required

Exact decimal string when published by the venue.

price_incrementstring nullable required

Exact venue price increment; null when not established.

size_incrementstring nullable required

Exact venue quantity increment; null when not established.

Example response

[
  {
    "instrument_id": "hl-mainnet-btc-usdt",
    "display_symbol": "BTC-USDT",
    "quote_asset_id": "USDT"
  }
]

Changes

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