---
title: "List OHLCV data"
method: GET
path: "/market_data/ohlcv"
tags: ["Market Data"]
---

# List OHLCV data

`GET /market_data/ohlcv`

Retrieves an list of historical data of open, high, low, close, underlying_volume and quoted_volume.

## Query parameters

- `underlying` 'USDC.OPTIMISM' | 'USDC.SUI' | 'DOT' | 'FIL' | 'PYUSD.ETH' | 'TRX' | 'ZRX' | 'DAI.ETH' | 'USDC.WORLDCHAIN' | 'USDP' | 'USDT.BSC' | 'USDT.CELO' | 'PEPE.ETH' | 'SAND' | 'USDC.DOTHUB' | 'USDC.SEI' | 'USDC.SOL' | 'USDC.ZKSYNC' | 'ENA.ETH' | 'MANA.ETH' | 'PYTH.SOL' | 'SOL' | 'USDC.BASE' | 'USDC.CELO' | 'USDT' | 'ADA' | 'INJ.ETH' | 'MATIC.POLYGON' | 'PAXG' | 'USD' | 'AAVE.ETH' | 'ALGO' | 'EURC.XLM' | 'KNC.ETH' | 'PNUT.SOL' | 'SHIB' | 'BCH' | 'DOGE' | 'EGLD' | 'JTO.SOL' | 'UNI.ETH' | 'USDC' | 'USDC.ARBITRUM' | 'ONDO.ETH' | 'PENGU.SOL' | 'USD' | 'WLFI.ETH' | 'XLM' | 'APT' | 'CC' | 'ETH.OPTIMISM' | 'ETH.WORLDCHAIN' | 'LDO.ETH' | 'MORPHO.ETH' | 'SEI' | 'ETH.ZKSYNC' | 'USDC.AVAX' | 'USDC.XLM' | 'USDT.DOTHUB' | 'USDT.SOL' | 'MANA' | 'USDC.ALGO' | 'MATIC.ETH' | 'NEAR' | 'UNI' | 'USDT.ARBITRUM' | 'USDT.AVAX' | 'OMG' | 'ARB.ARBITRUM' | 'COMP.ETH' | 'GRT.ETH' | 'USDC.POLYGON' | 'AVAX' | 'AAVE' | 'CELO' | 'PYUSD.SOL' | 'PAXG.ETH' | 'USDC.MONAD' | 'BAT' | 'COMP' | 'ETH.ARBITRUM' | 'ETH.BASE' | 'OP.OPTIMISM' | 'TRUMP.SOL' | 'ENJ.ETH' | 'SUI' | 'USDT.ETH' | 'USDT.OPTIMISM' | 'USDT.TRX' | 'USDT.XPL' | 'OMG.ETH' | 'XRP' | 'HBAR' | 'USDC.APT' | 'USDC.ETH' | 'BNB' | 'ATOM' | 'BAT.ETH' | 'GRT' | 'LINK.ETH' | 'USDP.SOL' | 'ZK.ZKSYNC' | 'BONK.SOL' | 'KNC' | 'TIA' | 'ZRO.ETH' | 'ZRX.ETH' | 'PUMP.SOL' | 'USD' | 'XTZ' | 'CRV.ETH' | 'GALA.ETH' | 'TON' | 'USDT.POLYGON' | 'WBTC.ETH' | 'XPL' | 'BTC' | 'MON' | 'SHIB.ETH' | 'USDC.BSC' | 'WLD.WORLDCHAIN' | 'W.SOL' | 'LTC' | 'RLUSD.ETH' | 'WBTC' | 'LINK' | 'USDCX.CANTON' | 'ETH' | 'WIF.SOL' | 'APE.ETH' | 'EURC' | 'MKR.ETH' | 'RLUSD.XRP', required — The underlying asset in the trading pair. E.g. `BTC` in the pair `BTC/USD`.
- `quoted_currency` 'USD' | 'EUR', required — The quoted currency in the trading pair. E.g. `USD` in the pair `BTC/USD`.
- `limit` string
- `data_end_date` string
- `all_data` boolean
- `time_frame` 'minute' | 'hourly' | 'daily', required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Historical OHLCV series for the requested underlying/quoted pair.

- GetOHLCVResponse
  - `message` OHLCVResponseEntity[]
    - `time` number — Unix timestamp in seconds marking the start of this data point.
    - `high` number — Highest price of the requested pair for this period of time
    - `low` number — Lowest price of the requested pair for this period of time
    - `open` number — Price of the requested pair at the start of this period of time
    - `underlying_volume` number — Total amount of the underlying currency traded into the quoted currency during this period of time (in units of the underlying currency)
    - `quoted_volume` number — Total amount of the quoted currency traded into the underlying currency during this period of time (in units of the quoted currency)
    - `close` number — Price of the requested pair at the end of this period of time
    - `average_transaction_price` number — Average transaction price (in units of the quoted currency)

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)