---
title: "Get OHLC candles for an asset by chain and address"
url: https://docs.truemarkets.co/api/market-data/get-asset-candles
description: "Returns open/high/low/close buckets for any asset, taken from its most liquid pool. Candles come at the finest size at or above resolution that keeps the window within 1,000 candles, and daily past that, so the resolution in the response can be coarser than the one requested."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get OHLC candles for an asset by chain and address

Returns open/high/low/close buckets for any asset, taken from its most
liquid pool. Candles come at the finest size at or above `resolution`
that keeps the window within 1,000 candles, and daily past that, so the
`resolution` in the response can be coarser than the one requested.

See the [Time Window & Resolution](https://docs.truemarkets.co/api/market-data/market-data-service-api#time-window--resolution)
section for the format of `window` and `resolution`.

## Request

```
GET https://api.truemarkets.co/v1/defi/market/assets/candles
```

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chain` | query | string, one of `solana`, `base`, `arbitrum`, `robinhood` | yes | Chain the asset is on. |
| `address` | query | string | yes | Asset contract address (EVM) or mint address (Solana). |
| `window` | query | string | no | Lookback period (e.g. `1h`, `1d`, `7d`, `1M`). |
| `resolution` | query | string | no | Smallest candle size wanted (e.g. `1m`, `1h`, `1d`). |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Candle series for the asset

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `chain` | string, one of `solana`, `base`, `arbitrum`, `robinhood` | yes | A chain asset lookups cover |
| `address` | string | yes | Asset address, lowercased for EVM chains |
| `window` | string | yes | The time window used for the query |
| `resolution` | string | yes | The candle size served, which can be coarser than the one requested |
| `candles` | array of object | yes | List of OHLC buckets, oldest first |
| `candles[].t` | string | no | ISO 8601 timestamp of the bucket start |
| `candles[].open` | string | no | First price in the bucket |
| `candles[].high` | string | no | Highest price in the bucket |
| `candles[].low` | string | no | Lowest price in the bucket |
| `candles[].close` | string | no | Last price in the bucket |
| `candles[].volume` | string | no | Base-asset quantity traded in the bucket. Omitted for a price source that reports no trade sizes. |

### 400

Bad request

### 404

No asset at that address on the chain, or no trades in the window

### 500

Internal server error

### 503

Asset data is temporarily unavailable
