# Crypto Market Rankings API

> Crypto Market Rankings API is a paid API for AI agents from x402-gateway-production.up.railway.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns cryptocurrency market rankings with price, volume, and market cap data, filterable by category

## Facts

- Endpoint: GET https://x402-gateway-production.up.railway.app/api/crypto/markets
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-production-up-railway-app-6434b5e6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7oP1BK0AzgerPs_txAwKP

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-gateway-production-up-railway-app-6434b5e6
```

Example prompt: Show me the top 20 cryptocurrencies ranked by market cap with their current prices, 24-hour trading volume, and filter it to just DeFi tokens.

## When to prefer this

Use this endpoint when you need ranked cryptocurrency market data with filtering by category (e.g. DeFi, NFT, Layer 1) and need price, volume, and market cap in a single call. Prefer over generic web search when structured, machine-readable market data is required for analysis or comparison.

## Known failure modes

- Invalid category filter returns empty list or 400 error
- Rate limiting or payment failure returns 402 or 429
- Unsupported currency parameter returns error
- Stale or delayed market data during high volatility periods
- Network timeout if upstream market data provider is slow

## How this service works

Market rankings with price, volume, market cap — filterable by category

## Output

Returns a ranked list of cryptocurrency assets including coin name, symbol, current price, market capitalization, 24-hour trading volume, percentage price change, and market cap rank — filterable by category such as DeFi, Layer 1, meme coins, etc.

## 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": {
      "page": {
       "type": "number",
       "default": 1,
       "example": 1,
       "description": "Page number (1-500)"
      },
      "limit": {
       "type": "number",
       "default": 100,
       "example": 100,
       "description": "Number of results (1-250)"
      },
      "order": {
       "type": "string",
       "default": "market_cap_desc",
       "example": "market_cap_desc",
       "description": "Sort order"
      },
      "category": {
       "type": "string",
       "example": "decentralized-finance-defi",
       "description": "Filter by category ID"
      },
      "currency": {
       "type": "string",
       "default": "usd",
       "example": "usd",
       "description": "Fiat currency for pricing"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-production-up-railway-app-6434b5e6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway-production.up.railway.app](https://www.zero.xyz/host/x402-gateway-production.up.railway.app/llms.txt)