Get OHLCV window

Read compact short-range OHLCV data for one market.

Use this for ranking, anomaly checks, or prompt context without pulling a full chart payload.

Access

Surfaces: mcp, rest, skill
Metering: mcp_call, rest_call
Scope: DEX available · EVM family primary

Handles

Surface	Label	Value
`mcp`	MCP	`market.read_ohlcv`
`rest`	HTTP	`GET /v1/market/ohlcv-window`
`skill`	Skill	`market.read_ohlcv`

Contract notes

Send explicit chain, address, and interval values. See Parameter Contracts for shared validation rules.
Zero-address inputs such as 0x0000000000000000000000000000000000000000 and shorthand forms such as 0x0 are rejected.
Failed responses return machine-readable error.code plus both trace_id and request_id for support and retry diagnostics.

Request example


GET {GATEWAY_BASE_URL}/v1/market/ohlcv-window?market_kind=dex&chain=ethereum&address=0xC02aaA39b223FE8D0A0E5C4F27eAD9083C756Cc2&interval=1h&limit=5

Try send

Try OHLCV window

Send one direct browser request to the current hosted gateway base URL so the real network request is visible in devtools. The API key is only stored locally when you provide one.

API key (sent as header)Request pathGET

Response example


{
  "ohlcv_window": {
    "market_kind": "dex",
    "chain": "ethereum",
    "address": "0xC02aaA39b223FE8D0A0E5C4F27eAD9083C756Cc2",
    "interval": "1h",
    "points": [
      {
        "timestamp": 1711111111,
        "open": 182.1,
        "high": 183.4,
        "low": 181.6,
        "close": 182.9,
        "volume": 145230.12
      }
    ],
    "source_id": "multi-source-kline"
  },
  "freshness_ms": 250,
  "source_status": "healthy"
}

Request fields

Query parameters

Field	Type	Required	Notes
`market_kind`	`string`	Required	Market family. Use `dex` for now.
`chain`	`string`	Required	Chain key. Use an enabled EVM chain such as `ethereum` or `base`.
`address`	`string`	Required	canonical EVM token address for the selected public chain. Send the full 20-byte `0x...` contract address.
`interval`	`string`	Required	Candle interval.
`limit`	`number`	Required	Max candle count.

Response fields

OHLCV window

Field	Type	Notes
`ohlcv_window.market_kind`	`string`	Market family.
`ohlcv_window.chain`	`string`	Market chain.
`ohlcv_window.address`	`string`	Lookup address.
`ohlcv_window.interval`	`string`	Applied interval.
`ohlcv_window.points[]`	`array`	Returned candles.
`ohlcv_window.points[].timestamp`	`number`	Candle timestamp.
`ohlcv_window.points[].open / high / low / close`	`number`	OHLC values.
`ohlcv_window.points[].volume`	`number`	Candle volume.
`ohlcv_window.source_id`	`string`	Backing source id.

Response metadata

Field	Type	Notes
`freshness_ms`	`number`	Data age in milliseconds.
`source_status`	`string`	Source health for this response.