> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptoquant.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Active Symbols
> Discover the active trading symbols for a market endpoint.
## What it does
Discover the active trading symbols for a market endpoint. The `exchange` and `symbol` parameters on the market data endpoints are open-ended — these discovery endpoints enumerate the values that currently have data.
The `origin`/`instrument`/`metric` you pass must be a combination that exists as a data endpoint — see the [combination table](/v2/market/overview#endpoint-structure). `funding-rate`, `open-interest`, and `liquidation` are swap-only, so a `spot` request for those returns `404`.
## OpenAPI
````yaml openapi/v2-market.json GET /market/info/symbols
openapi: 3.0.0
info:
version: 2.0.0-beta
title: CryptoQuant Data API v2 — Market
description: >-
Market data endpoints of the CryptoQuant Data API v2 — exchange-level and
CryptoQuant-aggregated spot & derivatives data (OHLCV, trade, funding rate,
open interest, liquidation). Built on the v1 conventions: the
`status`/`result` envelope, Bearer token authentication, and the
`window`/`from`/`to` time parameters.
termsOfService: https://cryptoquant.com/terms-of-service
contact:
name: API Support
email: contact@cryptoquant.com
servers:
- url: https://api.cryptoquant.com/v2
description: Default server
security: []
tags:
- name: Market Data
- name: Market Discovery
paths:
/market/info/symbols:
get:
tags:
- Market Discovery
summary: List active symbols
description: >-
Active trading symbols for a specific endpoint
(origin/instrument/metric). "Active" = seen in the last 30 days.
Delisted or illiquid symbols are hidden here but can still be queried
directly with `from`/`to`.
operationId: V2marketInfoSymbols
parameters:
- name: origin
in: query
required: true
description: '`exchange` or `cq`.'
schema:
type: string
enum:
- exchange
- cq
example: exchange
- name: instrument
in: query
required: true
description: '`spot` or `swap`.'
schema:
type: string
enum:
- spot
- swap
example: spot
- name: metric
in: query
required: true
description: >-
Data type: `ohlcv`, `trade`, `funding-rate`, `open-interest`, or
`liquidation`. Only combinations that exist as data endpoints are
valid — `funding-rate`, `open-interest`, and `liquidation` are
swap-only (no `spot` variant), so a non-existent (origin,
instrument, metric) combination returns `404`.
schema:
type: string
enum:
- ohlcv
- trade
- funding-rate
- open-interest
- liquidation
example: ohlcv
- name: exchange
in: query
required: false
description: >-
Exchange name — required for `origin=exchange`, forbidden for
`origin=cq`.
schema:
type: string
example: binance
- name: base
in: query
required: false
description: Filter by base asset, e.g. `btc`.
schema:
type: string
- name: limit
in: query
required: false
description: Maximum symbols returned (default 10000, max 10000).
schema:
type: integer
default: 10000
maximum: 10000
responses:
'200':
description: Active symbols.
content:
application/json:
schema:
type: object
required:
- status
- result
properties:
status:
$ref: '#/components/schemas/Status'
result:
type: object
properties:
data:
type: array
items:
type: object
properties:
symbol:
type: string
description: Trading pair, e.g. `btc_usdt`.
base:
type: string
description: Base asset, e.g. `btc`.
quote:
type: string
description: Quote asset, e.g. `usdt`.
'404':
description: >-
The requested (origin, instrument, metric) combination is not a
valid market endpoint — `funding-rate`, `open-interest`, and
`liquidation` exist only for `swap`.
content:
application/json:
schema:
type: object
required:
- status
- result
properties:
status:
$ref: '#/components/schemas/Status'
result:
type: object
example:
status:
code: 404
message: >-
404 Not Found: Unknown market endpoint:
/v2/market/cq/spot/funding-rate
result: {}
security:
- AccessToken: []
x-codeSamples:
- lang: Shell
source: >-
curl -X GET
"https://api.cryptoquant.com/v2/market/info/symbols?origin=exchange&instrument=spot&metric=ohlcv&exchange=binance"
\
-H "Authorization: Bearer "
- lang: JavaScript
source: >-
fetch("https://api.cryptoquant.com/v2/market/info/symbols?origin=exchange&instrument=spot&metric=ohlcv&exchange=binance",
{ headers: { "Authorization": "Bearer "} })
.then(response => response.json())
.then(data => console.log(data))
- lang: NodeJS
source: |-
require('axios')
.get("https://api.cryptoquant.com/v2/market/info/symbols?origin=exchange&instrument=spot&metric=ohlcv&exchange=binance", { headers: { Authorization: 'Bearer ' } })
.then(response => console.log(response))
- lang: Ruby
source: >-
require 'net/http'
uri =
URI("https://api.cryptoquant.com/v2/market/info/symbols?origin=exchange&instrument=spot&metric=ohlcv&exchange=binance")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer "
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) {
|http| http.request(req) }
puts res.body
- lang: Python
source: >-
import requests
headers = {'Authorization': 'Bearer '}
url =
"https://api.cryptoquant.com/v2/market/info/symbols?origin=exchange&instrument=spot&metric=ohlcv&exchange=binance"
print(requests.get(url, headers=headers).json())
components:
schemas:
Status:
type: object
description: >-
Returned with every response; indicates whether the request was
successful.
required:
- code
- message
properties:
code:
type: integer
format: int32
description: HTTP status code.
message:
type: string
description: Text description of the error or success.
securitySchemes:
AccessToken:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
For each API request, include the `Authorization` HTTP header with
`Bearer {access_token}`.
````