Angolin Docs

Universe

Four read-only catalog endpoints, all under /v1: which exchanges, assets, and trading pairs the API actually has data for. Use these to discover valid exchange/base/quote values before calling the OHLCV endpoints, instead of hardcoding them.

Conventions

  • Unlike exchange_ohlcv/aggregated_ohlcv, these four endpoints are public — no X-API-Key header, no plan check, and calls here are never counted in your usage. See Authentication.
  • A successful response is a bare JSON array — no wrapper object, no total count.
  • On exchange_pairs/aggregated_pairs, an exchange, interval, or method value that doesn't resolve to a known one returns 404 — not an empty array. A required parameter left out returns 422 instead (FastAPI's own validation) — see Errors & rate limits.
  • first_close_ts/last_close_ts are that pair's earliest and latest close_ts under whatever filters scoped the call — they describe actual data coverage, not a schedule, and don't promise the range is gap-free.

GET /v1/exchanges

Every exchange the API has data for. No parameters.

curl "https://api.angolin.com/v1/exchanges"
[
  { "name": "binance", "creation_date": "2017-07-14", "closing_date": null }
]

GET /v1/assets

Every asset the API has data for — ticker is the canonical value to use as base/quote elsewhere (e.g. BTC, never a raw exchange symbol like XBT). No parameters.

curl "https://api.angolin.com/v1/assets"
[
  { "name": "Bitcoin", "asset_type": "CRYPTO", "ticker": "BTC" },
  { "name": "US Dollar", "asset_type": "FIAT", "ticker": "USD" },
  { "name": "Tether", "asset_type": "STABLECOIN", "ticker": "USDT" }
]

GET /v1/exchange_pairs

Every (base, quote) pair with at least one candle in exchange_ohlcv for one exchange and interval.

ParameterTypeRequiredDescription
exchangestringYesExchange natural key, e.g. "binance" — the only exchange seeded today.
intervalstringYesCandle interval: "1m", "1h", or "1d".
curl "https://api.angolin.com/v1/exchange_pairs?exchange=binance&interval=1h"
[
  {
    "base": "BTC",
    "quote": "USDT",
    "first_close_ts": "2019-09-08T17:00:00Z",
    "last_close_ts": "2026-09-22T13:00:00Z"
  }
]

GET /v1/aggregated_pairs

Every (base, quote) pair with at least one candle in aggregated_ohlcv for one interval. No exchange parameter — aggregation combines every contributing exchange by definition, see GET /v1/aggregated_ohlcv.

ParameterTypeRequiredDescription
intervalstringYesCandle interval: "1m", "1h", or "1d".
methodstringNoAggregation methodology. Omit to union every method together — see Methodology.
curl "https://api.angolin.com/v1/aggregated_pairs?interval=1h"
[
  {
    "base": "BTC",
    "quote": "USDT",
    "first_close_ts": "2019-09-08T17:00:00Z",
    "last_close_ts": "2026-09-22T13:00:00Z"
  }
]