# meld402 Token Report

> meld402 Token Report is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Aggregates CoinGecko/Coinpaprika market data, DexScreener on-chain liquidity pairs, and Fear & Greed index into a single structured token intelligence report

## Facts

- Endpoint: POST https://meld402.vercel.app/api/token/report
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-token-report-dbbf137b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YeK6XRxQ2BdKzW7rPSGOl

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 meld402-token-report-dbbf137b -d '<json body>'
```

Example prompt: Pull a full token report for ETH on the Ethereum chain — I want market cap, price, ATH, the top 5 DEX liquidity pairs, and the current fear and greed index all in one shot.

## When to prefer this

Choose this endpoint when you need a single-call, multi-source token intelligence report that combines CeFi market data (price, market cap, ATH) with DeFi on-chain liquidity (DEX pairs, TVL) and sentiment (fear & greed) in one stable schema. Prefer it over calling DexScreener, CoinGecko, and Fear & Greed APIs separately when you need aggregated data with a single USDC micropayment. Best for autonomous agents that need token research without managing multiple API keys or response schemas.

## Known failure modes

- Token not found for given symbol/name/address — returns empty or null market data
- Ambiguous token symbol matches multiple tokens — resolved_as field indicates match quality
- DexScreener pairs unavailable for obscure tokens — liquidity section may be empty
- Upstream source degraded — meta.degraded array lists affected sources, partial data returned
- Invalid chain ID supplied — no on-chain pairs filtered to that chain
- Payment not processed — x402 payment required before response is returned

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

A structured JSON report containing: resolved token identity (symbol, name, rank), full market metrics (price USD, market cap, 24h volume, 1h/24h/7d/30d price changes, ATH price and date, percent from ATH), market context (fear & greed value and classification, chain TVL), an array of top DEX liquidity pairs (exchange, chain, pair address, price, liquidity USD, 24h volume, price change), aggregate liquidity stats, and metadata including data sources and as-of timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "maxLength": 40,
   "minLength": 1,
   "description": "Restrict on-chain pairs to one DexScreener chain id, e.g. \"base\", \"ethereum\", \"solana\". Omit to consider every chain."
  },
  "query": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1,
   "description": "Token symbol, name, or contract address. Examples: \"ETH\", \"ethereum\", \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"."
  },
  "max_pairs": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "How many trading pairs to include, deepest liquidity first."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": "ETH",
   "market": {
    "id": "eth-ethereum",
    "name": "Ethereum",
    "rank": 2,
    "symbol": "ETH",
    "ath_date": "2025-08-24T19:24:38Z",
    "price_usd": 2449.67,
    "last_updated": "2026-08-23T21:01:29Z",
    "ath_price_usd": 4946.23,
    "market_cap_usd": 295005280065,
    "volume_24h_usd": 11885993575,
    "from_ath_percent": -50.5,
    "change_1h_percent": 0.39,
    "change_7d_percent": 30.78,
    "change_24h_percent": 1.65,
    "change_30d_percent": 0
   },
   "context": {
    "chain_name": "Ethereum",
    "fear_greed": {
     "value": 66,
     "published_at": "2026-08-23T00:00:00.000Z",
     "classification": "Greed"
    },
    "chain_tvl_usd": 60400000000
   },
   "liquidity": {
    "pairs": [
     {
      "dex": "uniswap",
      "url": "https://dexscreener.com/ethereum/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "chain": "ethereum",
      "fdv_usd": 295000000000,
      "price_usd": 2449.12,
      "base_symbol": "WETH",
      "pair_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "quote_symbol": "USDC",
      "liquidity_usd": 32100000,
      "volume_24h_usd": 14200000,
      "price_change_24h_percent": 1.61
     },
     {
      "dex": "aerodrome",
      "url": "https://dexscreener.com/base/0xcdac0d6c6c59727a65f871236188350531885c43",
      "chain": "base",
      "fdv_usd": null,
      "price_usd": 2448.9,
      "base_symbol": "WETH",
      "pair_address": "0xcdac0d6c6c59727a65f871236188350531885c43",
      "quote_symbol": "USDC",
      "liquidity_usd": 9100000,
      "volume_24h_usd": 4300000,
      "price_change_24h_percent": 1.58
     }
    ],
    "pair_count": 2,
    "top_pair_share": 0.78,
    "total_liquidity_usd": 41200000,
    "total_volume_24h_usd": 18500000
   },
   "resolved_as": "symbol_or_name"
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "dexscreener",
    "coinpaprika",
    "feargreed",
    "defillama"
   ],
   "degraded": [],
   "attribution": [
    "On-chain pair data by DexScreener (dexscreener.com)",
    "Market data by Coinpaprika (coinpaprika.com)"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-token-report-dbbf137b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meld402.vercel.app](https://www.zero.xyz/host/meld402.vercel.app/llms.txt)
