Skip to main content

Kwery supports a core set of assets across its data sources. Symbol format varies by source — the same asset uses different strings depending on the platform's naming convention.

Supported Assets

The following assets are available across one or more sources:

AssetDescription
BTCBitcoin
ETHEthereum
SOLSolana
XRPXRP

Symbol Strings by Source

Each source uses its own symbol format. Pass the exact string shown below as the symbol query parameter.

Assetbinancebinance_futureschainlinkhyperliquidpolymarketkalshi
BTCBTCUSDTBTCUSDTBTCBTCper-marketper-contract
ETHETHUSDTETHUSDTETHETHper-marketper-contract
SOLSOLUSDTSOLUSDTSOLSOLper-marketper-contract
XRPXRPUSDTXRPUSDTXRPXRPper-marketper-contract

Binance and Binance Futures

Symbols concatenate the base and quote asset with no separator. The quote asset is almost always USDT:

BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT

Spot and futures use the same symbol strings.

Chainlink and Hyperliquid

Symbols use the base asset only, uppercase:

BTC, ETH, SOL, XRP

Polymarket and Kalshi

Prediction market sources use market-specific identifiers (event slugs for Polymarket, contract tickers for Kalshi) rather than standardized asset symbols. Use the /v1/markets endpoint to discover available symbols:

# Polymarket markets
curl "https://kwery-api.com/v1/markets?source=polymarket" -H "X-API-Key: YOUR_KEY"

# Kalshi contracts
curl "https://kwery-api.com/v1/markets?source=kalshi" -H "X-API-Key: YOUR_KEY"

Programmatic Discovery

Use the /v1/symbols endpoint to get the full list of supported symbols with per-symbol metadata:

curl "https://kwery-api.com/v1/symbols" -H "X-API-Key: YOUR_KEY"

Response:

{
  "symbols": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "sources": ["binance", "binance_futures", "hyperliquid", "polymarket", "kalshi", "chainlink"],
      "intervals": ["1s", "5m", "15m", "1h", "4h", "1d"],
      "earliest_data": "2024-01-15T00:00:00Z"
    }
  ]
}

This is the fastest way to check what's available before making data queries. The endpoint costs 0 credits.

Validation

Passing an unrecognized symbol returns a 400 error:

{
  "error": "invalid_parameter",
  "message": "Symbol 'BTC-USD' is not available for source 'binance'. Use /v1/markets to list valid symbols."
}