> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Track Market OHLCV History Across Ethereum, Solana, BNB, Base & More

> Use the Market OHLCV History endpoint to retrieve OHLCV candlestick data for a specific pool or market by address.

The [**Get Market OHLCV History**](https://docs.mobula.io/rest-api-reference/endpoint/market-ohlcv-history) endpoint lets you retrieve OHLCV candlestick data for a specific pool or market by address.

This returns open, high, low, close, and volume values across a selected candle period across chains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.

It also supports batch queries when you need OHLCV history for multiple pools.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/tSwUHu2B1Ow" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## What this endpoint does

With this API, you can:

* Retrieve OHLCV (Open, High, Low, Close, Volume) candlestick data for a specific pool or market
* Support GET for a single market and POST batch queries for up to 10 markets
* Choose the candle resolution using the `period` parameter
* Set a time range using `from` and `to` timestamps in milliseconds
* Return USD prices (`usd=true` by default)

***

## What you’ll need

* Basic knowledge of REST APIs
* A pool address
* A Mobula API key

Note: All Mobula endpoints require an API key.\
Get a free API key: [Here](https://admin.mobula.io/)

Optional:

* DexScreener (to find pool addresses to test)

***

## When to use Market OHLCV History

Use this endpoint when you want to:

* Build candlestick charts for a specific pool or market when you already know the pool address
* Analyze price action and volume at the pool level across consistent candle periods
* Fetch historical OHLCV data for multiple pools using batch queries
* Use pool-based OHLCV instead of token-based OHLCV when you want data from a specific market

If you want token-level OHLCV history instead, use: [**Get Token OHLCV History**](https://docs.mobula.io/rest-api-reference/endpoint/token-ohlcv-history)

If you want market-level stats instead of candles, use: [**Get Market Details**](https://docs.mobula.io/rest-api-reference/endpoint/market-details)

***

## Walkthrough to Get Market OHLCV History

### 1. Prepare your query

The `market/ohlcv-history` endpoint requires two parameters:

| Parameter | Description                                              |
| --------- | -------------------------------------------------------- |
| `address` | Pool or market contract address                          |
| `chainId` | Chain identifier (example: `ethereum`, `base`, `solana`) |

Optional parameters you can use:

* `period`: Candle resolution. Examples include `1m`, `5m`, `1h`, `4h`, `1d`, `1w`. Default is `5m`.
* `from`: Start timestamp in milliseconds. Default is `0`.
* `to`: End timestamp in milliseconds. Default is current time.
* `amount`: Maximum number of candles to return.
* `usd`: Return USD prices. Default is `true`.
* `fill`: Forward-fill empty candles between trades so the series has no gaps. Default is `false`.

Tip: Make sure you select the correct chain, such as [Solana](https://docs.mobula.io/blockchains/solana) or [Ethereum](https://docs.mobula.io/blockchains/ethereum).

### 2. Find a pool address to test

To retrieve real market data:

* Open DexScreener
* Pick a token
* Open one of its trading pools
* Copy the pool contract address

This address is used as the `address` parameter.

### 3. Fill the API form

Once your pool address is ready:

* Paste it into the `address` field
* Enter the chain into `chainId`
* (Optional) add `period` or `from` / `to` filters if needed
* Click **Send** to retrieve OHLCV history

***

## Reviewing the response

Each item in the response represents a candlestick:

* `t`: Candle timestamp in milliseconds
* `o`: Opening price for the candle
* `h`: Highest price during the candle window
* `l`: Lowest price during the candle window
* `c`: Closing price for the candle
* `v`: Volume during the candle window

Batch query note:\
For POST batch requests, the response returns one entry per requested market with an `ohlcv` array and includes `address` and `chainId` for each market.\
If the market is not found, the entry can return an `error` field.

***

## Try It Live with Mobula Market OHLCV History Demo (UI)

You can also test this endpoint using our demo UI:

[Demo UI Homepage](https://mobula-demo-endpoint-production.up.railway.app/)

[Market OHLCV History Demo UI](https://mobula-demo-endpoint-production.up.railway.app/market-ohlcv-history)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/market-ohlcv-history)

***

## Summary

The [**Get Market OHLCV History**](https://docs.mobula.io/rest-api-reference/endpoint/market-ohlcv-history) endpoint helps you:

* Retrieve OHLCV candlestick history for a market using address and chainId
* Choose candle resolution with period and narrow the time range with from and to
* Batch query up to 10 markets with POST for dashboards and research tools
* Visualize OHLCV history instantly in the demo UI

***

## Try Mobula for Free

Try our free API today and start building in minutes.\
Get your free API key: [Here](https://admin.mobula.io/)