# Zapper Token Ranking

> Zapper Token Ranking is a paid API for AI agents from public.zapper.xyz, paid per call via x402, $0.0045/call, status down (last checked 2026-10-12).

Returns a ranked list of ERC20/crypto tokens, optionally personalized by Farcaster ID, with pagination support

## Facts

- Endpoint: POST https://public.zapper.xyz/x402/token-ranking?utm_source=zero.xyz
- Price: $0.0045/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Success rate: 0% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-zapper-xyz-9e9dee94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_51RF4pbOvy5AfXH0PtB0f

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 public-zapper-xyz-9e9dee94 -d '<json body>'
```

Example prompt: Show me the top 25 ranked tokens on Zapper, personalized for Farcaster user with FID 3.

## When to prefer this

Use this endpoint when you need a ranked or trending list of crypto tokens from Zapper's index, especially when personalization via Farcaster identity is desired. Prefer over generic token search endpoints when you want curated rankings rather than keyword-matched results.

## Known failure modes

- Invalid FID returns an error or unranked results
- Invalid cursor string causes pagination failure
- Requesting more items than supported limit may return default count
- Payment not included or insufficient USDC causes 402 rejection

## How this service works

Enterprise grade onchain data across 60+ chains - token prices, NFTs, portfolios, onchain search, Farcaster and more.

## Output

A paginated list of ranked tokens with metadata, ordered by Zapper's ranking algorithm. If a Farcaster ID is supplied, the ranking is personalized to that user's context. Includes a pagination cursor for fetching subsequent pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fid": {
   "type": "integer",
   "description": "Optional Farcaster ID (FID) to personalize ranking"
  },
  "after": {
   "type": "string",
   "description": "Cursor for pagination (get results after this cursor)"
  },
  "first": {
   "type": "integer",
   "default": 10,
   "description": "Number of items to return (pagination limit)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-zapper-xyz-9e9dee94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from public.zapper.xyz](https://www.zero.xyz/host/public.zapper.xyz/llms.txt)