Skip to content
Alchemy Logo

Get token candles (Premium)

GET
https://api.g.alchemy.com/trading/v1/{apiKey}/premium/tokens/{network}/{tokenAddress}/candles

Private preview: Paths, parameters, response fields, and tier names are provisional.

Compute units: 700 (proposed; pending validation).

Candles use Unix seconds UTC and USD decimal strings. Intervals without trades are omitted by default. Candles are built from the token’s pool activity. Aggregation across pools is available, with its request control pending.

Read tokenAddress on each candle to identify the token priced in USD.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

enumrequired

Supported networks for this operation during private preview.

Allowed values:

stringrequired

Token address.

Query Parameters

enumrequired

Candle interval. Empty intervals are omitted by default.

Allowed values:

stringformat: "date-time"required

Start of the requested UTC time range. Boundary inclusion is pending.

stringformat: "date-time"required

End of the requested UTC time range. Boundary inclusion is pending.

Responses

200

Successful response.

400

Invalid request parameters.

401

Invalid API key.

429

Request limit reached. Retry with backoff.

503

Data temporarily unavailable. Retry with backoff.

Was this page helpful?