Skip to content
ChordChordChord Docs

Candles

GET
/tokens/chart/{address}
curl --request GET \
  --url 'https://api.getchord.xyz/v1/tokens/chart/example?tf=1m'

OHLCV candles from Chord’s own tape, address-keyed — one call serves Arc and Robinhood Chain tokens (addresses cannot collide). 200 candles per page; before pages backwards for unlimited history. A token that is not on a curated list and not a side of an indexed pool is 404 UNKNOWN_TOKEN. For live candles subscribe on /v1/ws/live (see Streaming).

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
address
required

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/

Query Parameters

Section titled “Query Parameters”
tf
string
default: 1h
Allowed values: 1m 5m 15m 1h 4h 1d 1w

Timeframe.

before

Unix time, seconds, UTC.

integer

Return the 200 candles before this time (paging).

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
candles

Oldest first.

Array<object>
object
t

Unix time, seconds, UTC.

integer
o
number
h
number
l
number
c
number
v

USD volume in the bucket.

number
tf
string
source

db = Chord’s tape.

string
Example
{
  "candles": [
    {
      "t": 1789520400,
      "o": 76161.46230007616,
      "h": 93752.28222071448,
      "l": 73286.91828508611,
      "c": 73301.06410779823,
      "v": 22676.53
    },
    {
      "t": 1789524000,
      "o": 73332.39663202444,
      "h": 75694.61170208515,
      "l": 73332.39663202444,
      "c": 75694.61170208515,
      "v": 173955.23
    }
  ],
  "tf": "1h",
  "source": "db"
}

400

Section titled “400”

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

404

Section titled “404”

Nothing at this identity (NOT_FOUND, UNKNOWN_TOKEN, NO_ROUTE).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

503

Section titled “503”

The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). Retry later; do not treat it as an empty answer.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}