# Market Intelligence API – OHLCV Candles with Trade Flow

> Market Intelligence API – OHLCV Candles with Trade Flow is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Returns OHLCV candles (1m, 5m, 15m, or 1h) for a given symbol enriched with aggressive buy/sell volume split, buy pressure, VWAP, and trade count per candle derived from on-chain trade flow.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/intelligence/candles/ETHUSD?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-ohlcv-candles-with-trade-flow-fadf2ae4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZwOi6gmig-TCgVA2tvP_F

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-ohlcv-candles-with-trade-flow-fadf2ae4
```

Example prompt: Pull 5-minute OHLCV candles for ETHUSD with the aggressive buy/sell volume split, buy pressure, VWAP, and trade count so I can see who's driving price action right now.

## When to prefer this

Choose this endpoint when you need candle data enriched with microstructure signals — specifically aggressive buy/sell volume decomposition, buy pressure, and VWAP — rather than plain OHLCV. Ideal for trading agents that need to distinguish directional aggression from passive flow, or for strategies that rely on volume imbalance as a signal. Prefer over generic market data APIs when on-chain trade flow fidelity matters for crypto or tokenized equity symbols.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty response
- Unsupported interval value causes a validation error
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting or throttling if too many calls are made in a short window
- Network timeout if the on-chain data source is temporarily unavailable

## How this service works

Send a symbol (ETHUSD, BTCUSD, NVDA, TSLA, SPY, ...), get OHLCV candles (1m, 5m, 15m or 1h) with volume split into aggressive buys and sells, buy pressure, VWAP and trade count per candle, from on-chain trade flow.

## Output

A list of OHLCV candles for the requested symbol and interval, each enriched with: open, high, low, close, total volume, aggressive buy volume, aggressive sell volume, buy pressure (ratio), VWAP, and trade count — all sourced from on-chain trade flow data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "examples": [
        "ETHUSD"
       ],
       "description": "Asset symbol, e.g. ETHUSD, BTCUSD, NVDA, TSLA, XAUUSD"
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 60,
       "maximum": 500,
       "description": "Maximum number of results to return"
      },
      "interval": {
       "enum": [
        "1m",
        "5m",
        "15m",
        "1h"
       ],
       "type": "string",
       "default": "1m",
       "description": "Candle interval, e.g. 1m, 5m, 15m or 1h"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "description": "Example JSON response returned by this endpoint"
    }
   },
   "additionalProperties": true
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-ohlcv-candles-with-trade-flow-fadf2ae4/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)