Quickstart

Every call to the Angolin API needs an API key. Here's the shortest path from "no key" to your first candle.

1. Create an API key

Create one from API keys in your Angolin account. The key is shown once at creation — store it somewhere safe.

2. Make a request

Send it as an X-API-Key header on any /v1/... call:

curl "https://api.angolin.com/v1/exchange_ohlcv?exchange=binance&interval=1h&base=BTC&quote=USDT&start=2026-09-22T00:00:00Z&limit=2" \
  -H "X-API-Key: YOUR_API_KEY"

3. Read the response

A plain JSON array of candles, ordered oldest to newest — no envelope, no total count:

[
  {
    "exchange": "binance",
    "interval": "1h",
    "base": "BTC",
    "quote": "USDT",
    "close_ts": "2026-09-22T13:00:00Z",
    "open": 63250.12,
    "high": 63480.5,
    "low": 63100.0,
    "close": 63390.75,
    "base_volume": 812.4123,
    "quote_volume": 51420239.18,
    "source_provider": "binance",
    "source_channel": "vision",
    "flag": null
  },
  {
    "exchange": "binance",
    "interval": "1h",
    "base": "BTC",
    "quote": "USDT",
    "close_ts": "2026-09-22T14:00:00Z",
    "open": 63390.75,
    "high": 63520.0,
    "low": 63280.4,
    "close": 63465.9,
    "base_volume": 601.887,
    "quote_volume": 38124017.4,
    "source_provider": "binance",
    "source_channel": "vision",
    "flag": null
  }
]

Next steps

Endpoints — every parameter for both exchange_ohlcv and aggregated_ohlcv.
Universe — discover valid exchanges, assets, and pairs without an API key, before you plug values into the call above.
Methodology — how the aggregated series is computed.
Errors & rate limits — what a rejected or failed call looks like.