Skip to main content

Symbols

Returns all tradeable symbols with per-symbol source availability, supported intervals, and earliest data date.

Endpoint: GET /v1/symbols Cost: 0 credits Auth: Required — send your API key via X-API-Key header (recommended) or api-key query parameter. See Authentication.

Parameters

This endpoint takes no query parameters.

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"
    },
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "sources": ["binance", "binance_futures", "hyperliquid", "polymarket", "kalshi", "chainlink"],
      "intervals": ["5m", "15m", "1h", "4h", "1d"],
      "earliest_data": "2024-02-01T00:00:00Z"
    },
    {
      "symbol": "SOL",
      "name": "Solana",
      "sources": ["binance", "binance_futures", "hyperliquid", "polymarket", "kalshi", "chainlink"],
      "intervals": ["5m", "15m", "1h", "4h", "1d"],
      "earliest_data": "2024-02-01T00:00:00Z"
    },
    {
      "symbol": "XRP",
      "name": "XRP",
      "sources": ["binance", "binance_futures", "hyperliquid", "chainlink"],
      "intervals": ["5m", "15m", "1h", "4h", "1d"],
      "earliest_data": "2024-03-01T00:00:00Z"
    }
  ]
}

Response Fields

FieldTypeDescription
symbolstringUppercase asset ticker (e.g., BTC)
namestringHuman-readable asset name
sourcesstring[]Data sources that cover this symbol
intervalsstring[]Candle intervals available for this symbol (union across sources)
earliest_datastringISO-8601 timestamp of the earliest data point available

Example

Send your API key in the X-API-Key header (recommended) or as the api-key query parameter. Examples below use the header.

import requests

resp = requests.get(
    "https://kwery-api.com/v1/symbols",
    headers={"X-API-Key": "YOUR_KEY"},
)
data = resp.json()
for sym in data.get("symbols", []):
    print(f"{sym['symbol']}: {sym['sources']}")

Query parameter alternative: Add api-key=YOUR_KEY to the URL for quick tests; the header is recommended for production.