Skip to content
Alchemy Logo

Get pool candles (Premium)

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

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

Compute units: 700 (proposed; pending validation).

Support for more networks is planned. Candles use Unix seconds UTC and USD decimal strings. Intervals without trades are omitted by default.

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

Pool address or pool identifier.

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?