GET
/
token
/
{chain}
/
{tokenAddress}
/
candles
curl --request GET \
  --url https://api-dex.chainstream.io/token/{chain}/{tokenAddress}/candles \
  --header 'Authorization: Bearer <token>'
[
  {
    "open": "50.5",
    "close": "51.2",
    "high": "51.8",
    "low": "50.1",
    "volume": "1000000",
    "resolution": "1h",
    "time": 1709251200000
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
chain
enum<string>
required

A chain name listed in supported networks

Available options:
sol,
base
​
tokenAddress
string
required

An address of a token

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

Query Parameters

​
resolution
enum<string>
required

Time resolution for candle data. Note: 1s resolution data is only kept for the last 1 hour; 15s and 30s resolution data is kept for the last 6 hours; 1m resolution data is kept for the last 12 hours; data for other resolutions is stored permanently

Available options:
1s,
15s,
30s,
1m,
5m,
15m,
1h,
4h,
12h,
1d
​
from
number

Start timestamp (Unix epoch in milliseconds)

Example:

1741647950000

​
to
number

End timestamp (Unix epoch in milliseconds)

Example:

1741700970000

Response

200 - application/json
​
open
string
required

Opening price

Example:

"50.5"

​
close
string
required

Closing price

Example:

"51.2"

​
high
string
required

Highest price

Example:

"51.8"

​
low
string
required

Lowest price

Example:

"50.1"

​
volume
string
required

Trading volume

Example:

"1000000"

​
resolution
enum<string>
required

Time resolution for candle data. Note: 1s resolution data is only kept for the last 1 hour; 15s and 30s resolution data is kept for the last 6 hours; 1m resolution data is kept for the last 12 hours; data for other resolutions is stored permanently

Available options:
1s,
15s,
30s,
1m,
5m,
15m,
1h,
4h,
12h,
1d
Example:

"1h"

​
time
number
required

Candle timestamp (Unix epoch in milliseconds)

Example:

1709251200000

Was this page helpful?