Coins

coins.candles

OHLCV candles for a coin at 1 second to 1 week intervals.

Details

Endpoint: GET /v1/coins/:type/candles
Credits: 2
Rate class: Light. Counts against your light requests per second.

Returns candles oldest first: time (unix seconds, the candle's open), open, high, low, close in USD at that candle, and volumeUsd. interval is one of 1s, 1m, 5m, 15m, 1h, 4h, 1d, 1w (1s covers only the last five minutes). Bound the range with from and to (unix seconds or ISO). When more candles exist than limit, cursor is set; pass it back as cursor to continue into the past.

Parameters

Name	Type	Description
typerequired	string	Move coin type, URL-encoded in the path, for example 0x2::sui::SUI or 0xdeeb7a46...::deep::DEEP.
interval	string	Candle size.One of "1s", "1m", "5m", "15m", "1h", "4h", "1d", "1w". Default "1h".
from	string	Earliest candle: unix seconds or ISO date.
to	string	Latest candle: unix seconds or ISO date. Default now.
limit	integer	Most candles to return (the newest in range).Default 200. From 1 to 1000.
cursor	string	Cursor from the previous response; continues into the past.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP/candles?interval=1h&limit=24" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/coins/0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270%3A%3Adeep%3A%3ADEEP/candles?interval=1h&limit=24", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "coinType": "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270::deep::DEEP",
  "interval": "1h",
  "items": [
    {
      "time": 1793692800,
      "open": 0.015152795551585758,
      "high": 0.015164792475618442,
      "low": 0.014937749590718575,
      "close": 0.015075450588909377,
      "volumeUsd": 99606
    },
    {
      "time": 1793696400,
      "open": 0.015075450588909377,
      "high": 0.015334737379930513,
      "low": 0.015075450588909377,
      "close": 0.0152974555968608,
      "volumeUsd": 107257.92
    },
    {
      "time": 1793700000,
      "open": 0.0152974555968608,
      "high": 0.015491376371642801,
      "low": 0.015258355591202097,
      "close": 0.015418133113340251,
      "volumeUsd": 196416.62
    }
  ],
  "cursor": "1793692800",
  "asOf": {
    "checkpoint": 341483902,
    "timestamp": "2026-11-04T07:30:09.229Z",
    "lagMs": 2260
  }
}

Long lists are cut to a few items here.