Symbols

The universe: every Binance USDT perpetual the engine currently tracks, with the precision metadata you need to format prices correctly.

GET/v1/symbols

Osiris tracks the full set of USDT-margined perpetual futures on Binance, typically a bit over 500 pairs. The list is not static: Binance lists new perpetuals regularly and delists others, and our tracker follows along automatically. New listings appear here within minutes of their first trade and start accumulating candles and metrics immediately (some metric families need a minimum history before they produce values; see Metrics). Delisted pairs disappear from this list and their data is purged from the engine.

Treat this endpoint as the source of truth for "what can I ask about": every other endpoint answers 404 Unknown symbol for anything not in this list. A sensible integration fetches it at startup and refreshes hourly; churn is a few pairs per month, not per minute.

Request

Parameter	In	Description
`exchange`	query	Venue whose universe to list. See Exchanges. Default: Binance. Each venue serves its own pair list; fetch per venue you intend to query.

curl "https://osiristrader.com/api/v1/symbols?exchange=bybit" \
  -H "Authorization: Bearer osk_YOUR_KEY"

Response

{
  "data": [
    { "symbol": "BTCUSDT", "baseAsset": "BTC", "quoteAsset": "USDT", "pricePrecision": 1 },
    { "symbol": "ETHUSDT", "baseAsset": "ETH", "quoteAsset": "USDT", "pricePrecision": 2 },
    { "symbol": "1000PEPEUSDT", "baseAsset": "1000PEPE", "quoteAsset": "USDT", "pricePrecision": 7 }
  ]
}

Field	Type	Description
`symbol`	string	The pair name, always uppercase. This exact string is what every other endpoint expects.
`baseAsset`	string	The traded asset. Note Binance's convention for micro-priced coins: pairs like `1000PEPEUSDT` trade a 1000-unit lot, and the base asset is literally `1000PEPE`.
`quoteAsset`	string	Always `USDT` in the current universe.
`pricePrecision`	number	Decimal places Binance quotes this pair at. Use it to format prices and to round alert levels: a BTCUSDT level of `63981.55` makes no sense when the pair ticks in tenths.

Why precision matters more than it looks: metric and price payloads return full-resolution floats. Rendering them raw produces noise like 0.00000071234000001. Formatting with pricePrecision reproduces exactly what the exchange (and the Osiris UI) shows.

Errors

Candles