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.

Use this canonical page when you need an HTTP example or Try send for market candles.

Access

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

Handles

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

Availability

DEX OHLCV coverage is Available. Unsupported CEX paths return explicit errors.

Request example


GET https://gw-aql.tomo.services/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 (optional)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. Prefer the current EVM family such as `ethereum` or `base`; use `solana` only for the separate Beta lane.
`address`	`string`	Required	Token, market, or pool 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.