GET /v1/symbols

Updated

What does GET /v1/symbols do?

Every trading pair a venue lists, as the venue’s own symbols. Returns the list of pairs a venue currently lists, written as that venue’s own symbol strings. Use it to discover what you can query on a venue before calling latest or series.

The list tracks listings and delistings, so it is the honest current universe for that venue rather than a static file.

Authentication

API key required. Set $BF to the API base and pass your key in $BLACKFORGE_API_KEY.

Parameters

Query parameters for /v1/symbols
NameTypeRequiredDescription
exchangestringYesVenue whose traded symbols to list, e.g. "binance".

Parameter shapes from the live OpenAPI document.

Example request

curl -H "x-api-key: $BLACKFORGE_API_KEY" \
  "$BF/v1/symbols?exchange=binance"

Example response

Real response, captured (trimmed for reading; values move every window)
[
  "0GTRY",
  "0GUSDC",
  "0GUSDT",
  "1000CATTRY",
  "1000CATUSDC",
  "1000CATUSDT",
  "1000CHEEMSUSDC",
  "1000CHEEMSUSDT",
  "1000SATSTRY",
  "1000SATSUSDC",
  "1000SATSUSDT",
  "1INCHUSDC",
  "…"
]

Returns

A JSON array of the venue’s symbol strings.

Responses and errors

Status codes for /v1/symbols
StatusWhen
400The exchange parameter is missing or names a venue that is not covered.
401The x-api-key header is missing or not a valid key.
NoteA venue on your plan is required: Free reaches Binance, MEXC and Gate; the paid plans reach every venue.

← All endpoints · How the data is measured · Pricing

See it on the pairs you actually trade

Pick the exchanges and pairs you watch and the dashboard opens with their history already loaded.

Start free

The major exchanges · 14,000+ pairs · 150+ columns per pair · live

Contact

Talk to us

Questions about coverage, the API or a plan. We read everything.

Prefer email? hello@blackforge.so

With your consent we measure how the site is used, including session replay with every field you type masked. Nothing optional loads until you allow it. Cookie policy