Near-live price bars
price_candlesRead-onlyIdempotent
Near-live price bars (OHLCV) for a pair: interval "1h" (default) or "1d", oldest first, each bar { t, o, h, l, c, v }. This is the lane a bot reads to compute its OWN indicators (moving averages, momentum, whatever it wants), so CoinLobster does not need to ship them. NEAR-LIVE and separate on purpose from market_history, which is the daily archive that settles days behind: every reply carries newest_candle_age_min and stale so a live lane is never confused with a stopped one. Keyless covers the free pairs up to 168 bars; a paid plan covers every streamed pair up to 720 bars (asking for more returns the cap and says so in capped). The newest bar is still forming. Descriptive market data only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | Alias for pair. | |
| pair | No | Trading pair, for example ETH/USD. A bare symbol like ETH is read as ETH/USD. Defaults to BTC/USD when omitted. Keyless calls reach the free pairs only; a paid plan reaches every streamed pair. A pair this server does not stream comes back covered:false. | |
| limit | No | How many bars, newest-ending. Capped at 168 keyless and 720 on a paid plan; asking for more returns the cap, and the payload says so in `capped`. | |
| interval | No | Bar length: "1h" (default) or "1d". Anything else is read as 1h. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | One line saying what the numbers cover, or why there are none. Read it before reporting any zero as a market reading. | |
| pair | No | The pair these candles are for. | |
| as_of | No | The time of the newest bar, in milliseconds. | |
| count | No | How many rows this reply carries. | |
| stale | No | True only when the newest bar is older than a live lane explains. When true the numbers are stopped, not the current price. | |
| capped | No | Present only when an argument was cut down to a ceiling. Absent means nothing was clamped, so a smaller number than you asked for is the data and not a limit. | |
| candles | No | The bars, oldest first, each { t, o, h, l, c, v }: time, open, high, low, close and volume. The newest bar is still forming. This is the NEAR-LIVE lane, not the days-behind daily archive that market_history reads. | |
| covered | No | False when this server does not stream the pair at all. No plan adds it. | |
| interval | No | 1h or 1d. The bar length each candle covers. | |
| available | No | False when this lane could not answer: a producer is dark, the pair sits outside this plan, or the argument named something we do not carry. Absent or true means the numbers are a real reading, not a guess. | |
| free_pairs | No | The pairs a keyless connection can read, returned when the pair asked for is not one of them. | |
| stale_note | No | Present when stale is true: how far past live the newest bar has fallen. | |
| access_note | No | What this connection could not return and what lifts it. Always pass this on to the user: it is the only place that information appears. | |
| newest_candle_age_min | No | How many minutes old the newest bar is, so a live lane can be told from a stopped one. |