Market Data

Get Tickers

Changed on

Get tickers grouped by connector, with 24h base and quote volume where available.

Without connectors this returns the collected pool as-is. Naming connectors fetches them on demand (concurrently) through keyless public data connectors when the cache is missing or stale, so it works for exchanges no API keys are configured for; those connectors then join the background refresh cycle.

A connector that fails does not remove the others from the response: it is reported under errors alongside the successful results. An error status is returned only when nothing could be served at all.

get/market-data/tickers

Request

  • Base URL
    http://localhost:8000
  • URL
    http://localhost:8000/market-data/tickers
  • Auth
    HTTP basic

Query parameters

connectorsstring[] nullable

Restrict to these connectors. Accepts a comma-separated list or the parameter repeated. Omit to return the whole collected pool.

refreshboolean

Force a fresh fetch, ignoring the cache

max_agenumber nullable

Accept cached tickers up to this age in seconds

Response

Successful Response

tickersobject required

Connector to {trading pair: ticker} mapping

countsobject

Number of tickers per connector

updated_atobject

Unix timestamp of the last successful fetch, per connector

errorsobject

Connectors that could not be fetched, with the reason. Present only when some requested connectors succeeded and others failed

Changes