Skip to content

Source tickers · WebSocket ​

See connection, authentication and subscription limits in the WebSocket overview.

Unsubscribe

Subscription message (type: subscribe) ​

SENDsubscribe / sourceTickers

Client → server

Receive sourceTicker events. sources filters exchange IDs; omit it for all sources. Prices use quote, while the event retains the native pair and native quote. No interval filter applies.

Reply: subscribed

Message fields ​

FieldTypeRequiredDescription
typestringYesAlways subscribe.
Allowed: "subscribe"
idstringNoSubscription ID. Default: default. Reuse it to replace the subscription.
Default: "default"
symbolstringNoBase asset, e.g. BTC; do not append the quote currency.
symbolsstring[]NoBase assets. Combined with symbol when both are supplied.
quotestringNoJPY (default) or USD.
Allowed: "JPY", "USD"
Default: "JPY"
channelsstring[]YesProvide this value to subscribe only to this feed.
Allowed: ["sourceTickers"]
sourcesstring[]NoSource tickers only. Exchange IDs such as binance, bitbank. Omit for all sources.

Push message (e: sourceTicker) ​

RECEIVEsourceTicker

Server → client

Source ticker: s is the base asset and quote is the normalized output currency; p and q preserve the native pair and quote. c, b, a, o, h, and l use the currency in quote; v is base-asset quantity. Bid/ask or derived 24-hour fields may be absent while upstream quotes, FX, or usable recent minute data are unavailable. T is source time; E is Oracle publish time.

vc is true for native rolling-volume feeds or when all 1,440 preceding source minutes are present; false means v sums available bars and may be understated. Minute-derived v also includes the current active minute, so it can span up to one extra partial minute. Cross-currency live prices use the latest available FX rate at publication; T remains the upstream quote time.

Message fields ​

FieldTypeRequiredDescription
estringYesAlways sourceTicker.
Allowed: "sourceTicker"
EintegerYesOracle publish time, Unix milliseconds.
sstringYesBase asset symbol.
quotestringYesOutput price currency: JPY or USD.
Allowed: "JPY", "USD"
TintegerYesUpstream quote time, Unix milliseconds.
xstringYesExchange ID.
pstringYesNative exchange pair, e.g. BTCUSDT.
qstringYesNative quote currency, e.g. USDT.
cstringYesLatest price, as a decimal string.
bstringNoBest bid price in quote.
astringNoBest ask price in quote.
ostringNo24-hour open price in quote.
hstringNo24-hour high price in quote.
lstringNo24-hour low price in quote.
vstringNo24-hour base-asset volume, as a decimal string.
vcbooleanNoWhether the reported volume has complete coverage.