candles
OHLCV токена на интервалах от одной секунды до одной минуты, построенный из тех же сделок, что отдаёт token_trades.
Без истории
Свечи строятся с момента подписки. Истории и бэкфилла нет.
Subscribe
Требуется mint. Интервал и поведение live-обновлений — параметры, а не фильтры.
json
{
"op": "subscribe",
"stream": "candles",
"params": {
"mint": "8Wq…kR2p",
"interval": "15s",
"priceCurrency": "usd",
"detail": "full",
"liveUpdates": true
},
"id": 1
}Параметры
| Param | Type | Description |
|---|---|---|
mint | string | Обязательно. Mint токена. |
interval | string | Обязательно. 1s, 15s, 30s или 1m. |
priceCurrency | string | usd (по умолчанию) или sol; одна валюта на подписку. |
liveUpdates | boolean | По умолчанию true; false — только закрытые бары. |
detail | basic / full | Уровень полезной нагрузки; по умолчанию basic. |
Фильтры и все интервалы свечей доступны на всех планах, включая Free.
Event
json
{
"op": "event",
"sub": "cd_3a77",
"stream": "candles",
"cursor": "330112270:1:0",
"data": {
"interval": "15s",
"priceCurrency": "usd",
"openTime": 1785482160,
"open": 0.00001218,
"high": 0.00001218,
"low": 0.00001176,
"close": 0.00001182,
"volumeToken": 89760695.84,
"volumeUsd": 1093.29,
"volumeSol": null,
"trades": 37,
"buys": 24,
"sells": 13,
"closed": true
}
}Свечи — агрегаты, поэтому в data нет общего транзакционного конверта.
Basic fields
| Field | Type | Notes |
|---|---|---|
interval | string | Интервал подписки |
priceCurrency | usd | sol | Валюта, выбранная подпиской |
openTime | number | Начало бара в Unix-секундах |
open, high, low, close | number | OHLC в выбранной валюте |
volumeToken | number | Объём в токене |
closed | boolean | true на финальном баре интервала |
Full fields
| Field | Type | Notes |
|---|---|---|
volumeUsd | number | null | Есть при priceCurrency: "usd" |
volumeSol | number | null | Есть при priceCurrency: "sol" |
trades | number | Число сделок |
buys | number | Число покупок |
sells | number | Число продаж |
С liveUpdates: true открытый бар эмитится раз в секунду. Бар 1s закрывается каждую секунду и не имеет отдельных live-обновлений. События эмитятся только для интервалов, в которых были сделки.