# token-market-data

> token-market-data is a paid API for AI agents from chain.intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns comprehensive DEX market data for any ERC-20 token including USD price, liquidity, 24h volume, buy/sell counts, market cap, FDV, price change, first-pair age, and top 15 trading pairs across multiple EVM chains.

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/market?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-market-data-c5641c65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PhSOGccHw3fvubPCsQgk9

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 token-market-data-c5641c65
```

Example prompt: Pull the full DEX market data for the token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base — I want the price, liquidity, 24h volume, buy vs sell counts, market cap, FDV, and top trading pairs.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-metric DEX market snapshot for a specific token — covering price, liquidity, volume, buy/sell breakdown, market cap, FDV, and top pairs — all in a single call. It is preferable over the simpler token-price endpoint when you need more than just the current price, and over token-recent-trades when you want aggregated statistics rather than individual trade records. Supports Base (default), Ethereum, Arbitrum, Optimism, Polygon, and BSC via chain prefix.

## Known failure modes

- Invalid or non-existent token contract address returns an error or empty result
- Unsupported chain prefix returns an error
- Token with no DEX liquidity returns null or zero values for market metrics
- Rate limiting or payment failure returns a 402 or 429 error
- Newly launched token with very few trades may have incomplete or missing volume/price data

## How this service works

Token market data from every DEX pair: USD price, total liquidity, 24h volume, buys vs sells, market cap, FDV, price change, first-pair age and the top 15 pairs. Default chain Base; prefix another: ethereum:, arbitrum:, optimism:, polygon:, bsc:. $0.01 per call.

## Output

Returns a JSON object with the token's current USD price, total liquidity across all DEX pairs, 24h trading volume, separate buy and sell transaction counts, market capitalization, fully diluted valuation (FDV), percentage price change over 24h, the age of the first trading pair, and a ranked list of the top 15 DEX pairs with their individual metrics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-market-data-c5641c65/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.intel.rallylive.ca](https://www.zero.xyz/host/chain.intel.rallylive.ca/llms.txt)