StatusTerminal
APIUse casesOracleMCP & AgentsSDKsSkillsChangelog

Candles

GET
/v1/candles

OHLC bars in the TradingView UDF shape. v is always 0: an index price has no volume. At most 5000 bars per request.

Query Parameters

feed*string

A feed ID (either kind) or a symbol, such as Crypto.BTC/USD.

resolution*string

Bar size. 1, 5, 15, 60, 240 minutes or 1D; 1m, 5m, 15m, 1h, 4h, 1d also work.

Value in

  • "1"
  • "5"
  • "15"
  • "60"
  • "240"
  • "1D"
  • "1m"
  • "5m"
  • "15m"
  • "1h"
  • "4h"
  • "1d"
  • "D"
from*integer

Start, Unix seconds.

Range0 <= value
to*integer

End, Unix seconds, not before from.

Range0 <= value

Response Body

application/json

application/json

application/json

text/plain

text/plain

application/problem+json

curl -X GET "https://example.com/v1/candles?feed=Crypto.BTC%2FUSD&resolution=60&from=0&to=0"
{  "s": "ok",  "t": [    0  ],  "o": [    0  ],  "h": [    0  ],  "l": [    0  ],  "c": [    0  ],  "v": [    0  ]}

Pyth ID to Astra ID map GET

Every feed Astra serves, once, sorted by symbol, with its Astra ID and its Pyth-compatible ID when it has one. Paste your Pyth IDs into `pyth_ids` to see which ones Astra serves: the Hermes routes accept those IDs as they are, so a feed found here needs no change in the client. `missing` lists the requested IDs Astra does not serve, lower-case without `0x`. With neither `pyth_ids` nor `astra_ids` the whole list is returned, without `missing`. With either, only the matching feeds are returned, plus `missing`. `pyth_ids` matches Pyth-compatible IDs only and `astra_ids` Astra IDs only; both may be combined. `category` narrows the items and never adds to `missing`. The answer changes only on a deploy: it may be cached for an hour, and the unfiltered list carries an `ETag`. Send at most 200 IDs per request, `pyth_ids` and `astra_ids` together; longer URLs are rejected before they reach Astra. For more IDs, use several requests.

Feed status GET

Per feed, its status, age and source count, and whether the served value has gone stale. With `feed`, `feeds` holds that feed's entry only, and the status code says whether it is healthy: `200` when it is `trading` and not `stale`, `503` with the same body otherwise, so an uptime checker can watch one feed by its status code. A feed whose market closes, or a `reference` feed, answers `503` while it is so; watch a 24/7 feed.