Skip to main content
Beginner1 min read
Fetch hourly BTC candles from Binance Futures: 
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"
You should get a response like: 
{
  "series": [
    {
      "id": {
        "type": "TRADE_SIDE_AGNOSTIC_AGG",
        "exchange": "BINANCE_FUTURES",
        "rawSymbol": "BTCUSDT",
        "normalizedSymbol": "BTC-USDT",
        "category": "PERPETUAL",
        "interval": "HOUR",
        "coin": "BTC"
      },
      "points": [
        {
          "Point": {
            "open": 66499.9,
            "high": 66639.0,
            "low": 66400.0,
            "close": 66467.8,
            "volume": 2852.8330000000055,
            "timestamp": { "s": 1774800000 },
            "firstTimestamp": { "s": 1774800003, "ns": 234000000 },
            "lastTimestamp": { "s": 1774803599, "ns": 649000000 }
          }
        }
      ]
    }
  ]
}

​
What’s happening

  1. type=TRADE_SIDE_AGNOSTIC_AGG — requests candlestick data
  2. exchange=BINANCE_FUTURES — from Binance USDT-M Futures
  3. rawSymbol=BTCUSDT — for the BTC/USDT perpetual
  4. interval=HOUR — aggregated into 1-hour candles
  5. from=1774800000&period=3600 — 1 hour of data starting at that timestamp
  6. X-Kiyotaka-Key header — your API key for authentication

​
Next steps

Authentication

Get your API key and learn about auth

Exchanges & Symbols

Find exchange IDs and symbol formats

Data Types

Explore all available data types

Rate Limits

Understand weight costs and quotas