# x402 Crypto Data APIs – Top Cryptocurrencies

> x402 Crypto Data APIs – Top Cryptocurrencies is a paid API for AI agents from x402-crypto-apis.onrender.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns real-time price, market cap, 24h change, and rank for the top N cryptocurrencies, powered by CoinGecko, via x402 micropayment.

## Facts

- Endpoint: GET https://x402-crypto-apis.onrender.com/api/crypto/top
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-crypto-data-apis-top-cryptocurrencies-b5a44c24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uMxYQGkfXEthklXesRifH

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 x402-crypto-data-apis-top-cryptocurrencies-b5a44c24
```

Example prompt: Show me the top 10 cryptocurrencies right now — I want their current USD prices, 24-hour change, and market cap, ranked from biggest to smallest.

## When to prefer this

Choose this endpoint when you need a quick, ranked snapshot of the top cryptocurrency market — prices, market cap, and 24h change — without needing deep historical data or order book information. It is ideal for market overviews, dashboards, or agent workflows that need current macro crypto context. Prefer it over exchange-specific APIs when broad market ranking (CoinGecko-sourced) matters more than trading depth.

## Known failure modes

- Payment not included or rejected (402) — x402 payment header missing or insufficient USDC
- Invalid limit parameter (400) — non-integer or out-of-range value
- CoinGecko upstream unavailable (503) — data provider outage causing empty or stale response
- Rate limit exceeded — too many calls in a short window
- Network timeout on render.com cold start — first request may be slow if service is sleeping

## How this service works

AI Agent cryptocurrency data APIs with x402 v2 payment protocol. Real-time prices, market data, trading signals, and market overview powered by CoinGecko.

## Output

A ranked array of the top N cryptocurrencies, each including name, ticker symbol, rank, current USD price, 24-hour percentage change, and market cap, plus a response timestamp and total count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Number of top cryptocurrencies to return"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "name": {
      "type": "string"
     },
     "rank": {
      "type": "integer"
     },
     "symbol": {
      "type": "string"
     },
     "price_usd": {
      "type": "number"
     },
     "change_24h": {
      "type": "number"
     },
     "market_cap": {
      "type": "number"
     }
    }
   }
  },
  "count": {
   "type": "integer"
  },
  "timestamp": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-crypto-data-apis-top-cryptocurrencies-b5a44c24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-crypto-apis.onrender.com](https://www.zero.xyz/host/x402-crypto-apis.onrender.com/llms.txt)