---
updatedAt: 2026-02-17T07:38:45.000Z
agentTools:
  projectIndex: https://docs.tatum.io/llms.txt
---

# Candle Price Chart with Price API

Access reliable 1-minute cryptocurrency OHLCV data (Open, High, Low, Close, Volume) for 439+ trading pairs via Tatum’s Price Data API.

## Crypto OHLCV API (1-Minute Candlestick Data)

**This endpoint enables:**

* Real-time crypto trading charts
* Historical price analysis
* Algorithmic trading backtesting
* Quantitative strategy development
* Market data dashboards

Prices are returned in USD by default.

<HTMLBlock>{`
<div data-widget="candle-charts"></div>
`}</HTMLBlock>

*Additional timeframes (5m, 15m, 1h, 1d and more) are coming soon to the API, allowing you to build multi-timeframe price charts and advanced technical analysis directly from native endpoints.*

## Example Request

> 📘 **Get OHLCV by Symbol**
>
> `GET /v4/data/rate/symbol/OHLCV`\
> Retrieve **1-minute OHLCV (Open, High, Low, Close, Volume)** data for a given symbol at a specific point in time.\
> [Explore Docs →](/reference/getsymbolohlcv)

### Get BTC Candle at Specific Time

```curl
curl --request GET \
     --url 'https://api.tatum.io/v4/data/rate/symbol/OHLCV?symbol=BTC&time=2026-02-15T00%3A00%3A00Z' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
```

#### Example Response

```json
{
  "symbol": "BTC",
  "openTime": 1771113600000,
  "open": "69822.94000000",
  "high": "69830.69000000",
  "low": "69793.24000000",
  "close": "69830.68000000",
  "volume": "6.00278000",
  "closeTime": 1771113659999,
  "quoteAssetVolume": "419102.60165970",
  "numberOfTrades": 2123,
  "takerBuyBaseAssetVolume": "3.53113000",
  "takerBuyQuoteAssetVolume": "246547.43442320"
}
```

## Time Handling

You must provide **exactly one** of:

* `time` → ISO date string (e.g., `2026-02-15T00:00:00Z`)
* `unix` → Unix timestamp in milliseconds

Behavior:

* If `openTime ≤ time < closeTime`, we return that candle.
* If time is later than available data, we return the most recent OHLCV record.
* If time is earlier than available data, we return the earliest available OHLCV record.
* If no exact match exists, we return the closest available record.

## What is OHLCV?

OHLCV stands for:

* **Open** – Price at the beginning of the candle
* **High** – Highest price during the interval
* **Low** – Lowest price during the interval
* **Close** – Final price of the interval
* **Volume** – Total traded volume during the interval

OHLCV data is the foundation of:

* Candlestick charts
* Technical indicators (RSI, MACD, Bollinger Bands)
* Quantitative trading models
* Market structure analysis

## Common Use Cases

### Build Crypto Trading Charts

Use 1-minute candles to render TradingView-style candlestick charts.

### Backtest Trading Strategies

Fetch historical OHLCV data at specific timestamps for algorithmic backtesting.

### Create Market Analytics Dashboards

Power portfolio apps, exchanges, and analytics platforms with structured price data.

### Develop Technical Indicators

Calculate RSI, MACD, EMA, VWAP, and other indicators using native OHLCV data.