# meld402 Token Intelligence

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

Aggregates multi-source crypto token data (market metrics, on-chain info, social stats) for a given token symbol, name, or contract address on a specified chain into a single unified response

## Facts

- Endpoint: POST https://meld402.vercel.app/api/token/intel
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-token-intelligence-2bc8404f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BZf-gicYAdXY8G3r_ov3y

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-intelligence-2bc8404f -d '<json body>'
```

Example prompt: Pull aggregated token intelligence for ETH on the Ethereum chain — I want price, market cap, ATH, on-chain address info, and social stats all in one shot.

## When to prefer this

Choose this endpoint when you need a single, unified view of a crypto token combining both market data and on-chain data in one call, without stitching together multiple APIs yourself. It is especially useful for agents that need a quick, stable schema across many chains (eth, base, polygon, arb, opt, etc.) and want social/developer activity metrics alongside price data. Prefer it over raw CoinGecko or Etherscan calls when you want normalized, multi-source output with built-in attribution and degradation tracking.

## Known failure modes

- Token not found for the given query string — returns empty or error response
- Chain identifier not recognized — may return data for default chain or error
- Upstream source (CoinGecko or block explorer) degraded — response may be partial with affected sources listed in meta.degraded
- Payment not received or insufficient — x402 payment required error before data is returned
- Contract address on wrong chain — on_chain data may be empty or mismatched

## 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 JSON object containing a `data` field with a `token` sub-object (price, ATH/ATL, market cap, volume, supply, description, GitHub and social metrics) and an `on_chain` sub-object (contract address, balance, verification status, transaction counts), plus a `meta` field listing data sources, degraded sources, and attribution strings with timestamps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Filter by chain (eth, polygon, arb, opt, base, etc.)"
  },
  "query": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1,
   "description": "Token symbol, name, or contract address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "chain": "eth",
   "token": {
    "id": "eth-ethereum",
    "name": "Ethereum",
    "image": "https://assets.coingecko.com/coins/images/279/large/ethereum.png",
    "symbol": "ETH",
    "ath_usd": 4946.23,
    "atl_usd": 0.43,
    "ath_date": "2025-08-24T19:24:38Z",
    "atl_date": "2015-10-20T00:00:00Z",
    "price_usd": 2449.67,
    "max_supply": null,
    "description": "Ethereum is a decentralized platform that runs smart contracts.",
    "github_forks": 14000,
    "github_stars": 45000,
    "last_updated": "2026-08-23T21:01:29Z",
    "total_supply": 120420000,
    "market_cap_usd": 295005280065,
    "volume_24h_usd": 11885993575,
    "github_commits_4w": 150,
    "twitter_followers": 3500000,
    "circulating_supply": 120420000,
    "reddit_subscribers": 1400000,
    "price_change_24h_percent": 1.65
   },
   "on_chain": {
    "address": "0x0000000000000000000000000000000000000000",
    "eth_balance": "0",
    "is_verified_contract": false,
    "token_transfers_count": 0,
    "recent_transactions_count": 0
   }
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "coingecko",
    "etherscan"
   ],
   "degraded": [],
   "attribution": [
    "Market data by CoinGecko (coingecko.com)",
    "Blockchain data by Etherscan (etherscan.io)"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meld402-token-intelligence-2bc8404f/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)
