# Market Intelligence API – Token On-Chain Flow Intelligence

> Market Intelligence API – Token On-Chain Flow Intelligence is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns on-chain buy/sell pressure, trade flow signals, price change, and a pre-trade verdict (e.g. ACCUMULATION) for a given crypto token contract address.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/intelligence/token/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.01/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-token-on-chain-flow-intelligence-9eec1af2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2TsjLKDnrREpbsjYkDmqh

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-token-on-chain-flow-intelligence-9eec1af2
```

Example prompt: Check the on-chain buy/sell pressure and trade verdict for the AERO token at contract address 0x940181a94a35a4569e4529a3cdfb74e38fd98631 on Base — is it being accumulated or distributed right now?

## When to prefer this

Use this endpoint when you need real-time on-chain trade flow analysis and a pre-trade verdict for a specific crypto token by contract address, particularly on Base, Arbitrum, or Optimism. Prefer this over price-only feeds when you need buy/sell pressure, accumulation signals, or recipient concentration data to inform a trading decision or alert. Choose this over the batch endpoint when querying a single token in real time.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Unsupported chain parameter returns an error
- Token with very low liquidity may return sparse or zero trade data
- Network congestion or indexing lag may result in stale flow data
- Malformed address (wrong checksum or length) returns a validation error

## 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: on-chain flow metrics (trade count, buy pressure %, buy and sell volume in USD, largest trade, unique recipients, top-5 recipient share), current and opening price with percentage change, the token contract address and chain, the analysis time window in minutes, a human-readable verdict string (e.g. 'ACCUMULATION'), supporting reasons for the verdict, and token metadata (name, symbol, decimals).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "flow": {
   "trades": 214,
   "buyPressure": 60.1,
   "buyVolumeUsd": 182340.5,
   "sellVolumeUsd": 121007.2,
   "largestTradeUsd": 24500,
   "uniqueRecipients": 97,
   "top5RecipientSharePercent": 38.4
  },
  "chain": "base",
  "price": {
   "lastUsd": 0.8612,
   "firstUsd": 0.8421,
   "changePercent": 2.27
  },
  "token": "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
  "window": {
   "approxMinutes": 60
  },
  "reasons": [
   "Buyers took 60% of swap volume and price rose 2.27%"
  ],
  "verdict": "ACCUMULATION",
  "tokenInfo": {
   "name": "Aerodrome",
   "symbol": "AERO",
   "decimals": 18
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-token-on-chain-flow-intelligence-9eec1af2/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)