# Market Intelligence API – Historical Datasets (Candles by Symbol)

> Market Intelligence API – Historical Datasets (Candles by Symbol) is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Returns historical OHLCV candle data with buy/sell pressure and volume metrics for a given crypto or US equity symbol.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/datasets/%7Bsymbol%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-historical-datasets-candles-by-symbol-595527c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IUUzdwpFAi8trzdAe1i6P

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market-intelligence-api-historical-datasets-candles-by-symbol-595527c3
```

Example prompt: Pull the full historical 1-minute candle dataset for ETHUSD, including buy/sell pressure and VWAP, so I can analyze trading patterns over the past day.

## When to prefer this

Use this endpoint when you need bulk historical OHLCV candle data for a specific symbol — especially when buy/sell pressure and venue-level breakdown are required. Prefer this over the live signals or pre-trade verdict endpoints when doing backtesting, charting, or offline analysis rather than real-time decision-making.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty dataset
- Payment not included or insufficient USDC causes 402 payment required
- Symbol format mismatch (e.g. using 'ETH' instead of 'ETHUSD') may return no data
- Rate limiting or network timeouts for high-frequency polling
- No data available for requested symbol/date combination

## How this service works

Pay-per-call market intelligence for AI agents across crypto, US and European stocks, rates and FX: on-chain buy/sell pressure, trading decisions from $0.05, token risk checks on six chains, webhook alerts, pre-trade verdicts, technicals, perps funding, smart money, SEC and ESEF fundamentals, insider trades, European short interest, ECB rates and FX, datasets and news.

## Output

Returns a JSON object containing the symbol, date, interval (e.g. '1m'), number of rows, list of venues, and an array of candle objects each with open, high, low, close, VWAP, volume, buyVolume, sellVolume, buyPressure, trade count, volumeUsd, and timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-09-23",
  "rows": 1440,
  "symbol": "ETHUSD",
  "venues": [
   "onchain_dex"
  ],
  "candles": [
   {
    "low": 2667.8,
    "high": 2669.4,
    "open": 2668.1,
    "time": "2026-09-23T00:00:00Z",
    "vwap": 2668.8,
    "close": 2669,
    "venue": "onchain_dex",
    "trades": 41,
    "volume": 12.4,
    "buyVolume": 7.9,
    "volumeUsd": 33093.6,
    "sellVolume": 4.5,
    "buyPressure": 63.71
   }
  ],
  "interval": "1m"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-historical-datasets-candles-by-symbol-595527c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)