--- updatedAt: 2026-06-02T20:06:00.000Z agentTools: projectIndex: https://docs.zerohash.com/llms.txt --- # List OHLCV data Retrieves an list of historical data of open, high, low, close, underlying_volume and quoted_volume. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "zerohash API", "description": "\n### Authentication\n\nzerohash Uses HMAC SHA-256 verification to ensure the authenticity of API requests, follow instructions by link [https://docs.zerohash.com/reference/api-authentication](https://docs.zerohash.com/reference/api-authentication)\n\nDownload zerohash OpenAPI Schema as JSON\n", "version": "1.7.0" }, "servers": [ { "url": "https://api.cert.zerohash.com", "description": "Certification API server" } ], "x-readme": { "proxy-enabled": false }, "tags": [ { "name": "Market Data", "description": "Market Data Services" } ], "paths": { "/market_data/ohlcv": { "get": { "tags": [ "Market Data" ], "summary": "List OHLCV data", "description": "Retrieves an list of historical data of open, high, low, close, underlying_volume and quoted_volume.", "parameters": [ { "$ref": "#/components/parameters/Signature" }, { "$ref": "#/components/parameters/Timestamp" }, { "name": "underlying", "in": "query", "description": "Filter for underlying asset in the trading pair. E.g., `BTC` for `BTC/USD` related OHLCV data.", "required": true, "schema": { "$ref": "#/components/schemas/LiquidityEnabledUnderlyingCurrency" } }, { "name": "quoted_currency", "in": "query", "description": "Filter for quoted asset in the trading pair. E.g., `USD` for `BTC/USD` related OHLCV data.", "required": true, "schema": { "$ref": "#/components/schemas/LiquidityEnabledQuotedCurrency" } }, { "name": "limit", "in": "query", "description": "Filter for maximum number of data points to be returned in a single request. Default is `50` if not specified, and the maximum value that can be passed in the `limit` field is `2000`.", "required": false, "example": "100", "schema": { "type": "string" } }, { "name": "data_end_date", "in": "query", "description": "Filter for objects before given timestamp. E.g., `1780876800` for June 8, 2026.", "required": false, "example": "1780876800", "schema": { "type": "string" } }, { "name": "all_data", "in": "query", "description": "Filter for all data available. Defaults to `false`. If set to `true`, `time_frame` is ignored and all available data is returned with `daily` granularity.", "required": false, "example": false, "schema": { "type": "boolean" } }, { "name": "time_frame", "in": "query", "description": "Filter for `time_frame` of the OHLCV data. Required if `all_data` is not set to `true`. E.g., `daily` for daily OHLCV data.", "required": true, "example": "daily", "schema": { "type": "string", "enum": [ "minute", "hourly", "daily" ] } } ], "responses": { "200": { "description": "Historical OHLCV series for the requested underlying/quoted pair.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetOHLCVResponse" }, "example": { "message": [ { "time": 1682899200, "high": 28151.81, "low": 27940.52, "open": 28086.19, "underlying_volume": 2900.51, "quoted_volume": 81300199.13, "close": 27952.92, "average_transaction_price": 28029.6220768072 }, { "time": 1682985600, "high": 28410.05, "low": 27810.4, "open": 27952.92, "underlying_volume": 3120.44, "quoted_volume": 87650420.77, "close": 28305.11, "average_transaction_price": 28110.3374 } ] } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code400" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code403" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code404" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code500" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Code503" } } } } } } } }, "security": [ { "apiKey": [], "apiPassphrase": [] } ], "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "description": "Your API public key. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for how to obtain keys.", "in": "header", "name": "X-SCX-API-KEY" }, "apiPassphrase": { "type": "apiKey", "description": "The passphrase associated with your API key, set when the key was created.", "in": "header", "name": "X-SCX-PASSPHRASE" } }, "parameters": { "Signature": { "name": "X-SCX-SIGNED", "in": "header", "description": "HMAC-SHA256 signature of the request, base64-encoded. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for the exact signing formula.", "required": true, "schema": { "type": "string" } }, "Timestamp": { "name": "X-SCX-TIMESTAMP", "in": "header", "description": "Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.", "required": true, "schema": { "type": "string", "example": "1678901234" } } }, "schemas": { "Code400": { "type": "object", "description": "Request was rejected by validation or a downstream service. `errors` is an array of human-readable messages; each entry describes a single validation failure or business-rule violation.", "required": [ "errors" ], "properties": { "errors": { "type": "array", "items": { "type": "string" }, "example": [ "body/amount must be >= 0", "body/asset is required" ] } } }, "Code403": { "type": "object", "description": "Authentication or authorization failed. `error` is always `true`; `message` explains which check failed (missing API key, bad signature, insufficient permission, etc.).", "required": [ "error", "message" ], "properties": { "error": { "type": "boolean", "example": true }, "message": { "type": "string", "example": "This api key does not have write permission to this endpoint" } } }, "Code404": { "type": "object", "description": "The requested resource does not exist or is not visible to the caller.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Not Found" } } }, "Code500": { "type": "object", "description": "An unexpected error occurred on the server. The request can be retried after a short delay, but the same inputs may reproduce the error.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Internal Server Error" } } }, "Code503": { "type": "object", "description": "A downstream dependency was unavailable, timed out, or returned a retryable error. Safe to retry; the response carries a `zh-allow-retry: true` header.", "required": [ "error" ], "properties": { "error": { "type": "string", "example": "Service Unavailable" } } }, "LiquidityEnabledUnderlyingCurrency": { "type": "string", "description": "The underlying asset in the trading pair. E.g. `BTC` in the pair `BTC/USD`.", "example": "BTC", "enum": [ "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" ] }, "LiquidityEnabledQuotedCurrency": { "type": "string", "description": "The quoted currency in the trading pair. E.g. `USD` in the pair `BTC/USD`.", "example": "USD", "enum": [ "USD", "EUR", "USDC.ETH" ] }, "GetOHLCVResponse": { "type": "object", "properties": { "message": { "type": "array", "items": { "$ref": "#/components/schemas/OHLCVResponseEntity" } } } }, "OHLCVResponseEntity": { "type": "object", "properties": { "time": { "type": "number", "description": "Unix timestamp in seconds marking the start of this data point.", "example": 1682899200 }, "high": { "type": "number", "description": "Highest price of the requested pair for this period of time", "example": 28151.81 }, "low": { "type": "number", "description": "Lowest price of the requested pair for this period of time", "example": 27940.52 }, "open": { "type": "number", "description": "Price of the requested pair at the start of this period of time", "example": 28086.19 }, "underlying_volume": { "type": "number", "description": "Total amount of the underlying currency traded into the quoted currency during this period of time (in units of the underlying currency)", "example": 2900.51 }, "quoted_volume": { "type": "number", "description": "Total amount of the quoted currency traded into the underlying currency during this period of time (in units of the quoted currency)", "example": 81300199.13 }, "close": { "type": "number", "description": "Price of the requested pair at the end of this period of time", "example": 27952.92 }, "average_transaction_price": { "type": "number", "description": "Average transaction price (in units of the quoted currency)", "example": 28029.6220768072 } } } } } } ```