Skip to main content
The Get 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, Ethereum, BNB Chain, Base, and more. It also supports batch queries when you need OHLCV history for multiple pools.

​
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 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 If you want market-level stats instead of candles, use: Get Market Details

​
Walkthrough to Get Market OHLCV History

​
1. Prepare your query

The market/ohlcv-history endpoint requires two parameters:
ParameterDescription
addressPool or market contract address
chainIdChain 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.
Tip: Make sure you select the correct chain, such as Solana or 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 Market OHLCV History Demo UI Docs

​
Summary

The Get 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