Search for ERC20 tokens, NFTs, users, apps, and gas tokens across 60+ chains via x402 micropayment.
What it does
Zapper's `/x402/search` endpoint lets you search across ERC20 tokens, gas tokens, NFT collections, users (ENS/Basenames), and dApps by keyword. It is one of 17 paid tools in the Zapper x402 API suite, which provides onchain data across 60+ chains including token prices, portfolios, NFT metadata, transaction history, and social identity resolution.
The search accepts a text query and optional category filters (`ERC20_TOKEN`, `GAS_TOKEN`, `NFT_COLLECTION`, `USER`, `APP`). Results are polymorphic — each result includes fields relevant to its category (e.g., `symbol` and `decimals` for tokens, `collection.floorPrice` for NFTs, `account.farcasterProfile` for users). You can limit results per category with `maxResultsPerCategory` (default 5).
Payment is handled via the x402 protocol on Base (chain 8453) using USDC. Each call costs 4,500 base units of USDC (6 decimals), which equals $0.0045 per request. The endpoint also supports MPP (Tempo) settlement. The x402 challenge was confirmed live, returning a proper 402 with payment parameters. This is part of the broader Zapper API, which is migrating from its legacy v2 REST API to these x402-gated POST endpoints.
Capabilities
Use cases
- —Finding ERC20 token contract addresses and metadata by symbol or name
- —Discovering NFT collections by name with floor price data
- —Resolving ENS names and Basenames to wallet addresses
- —Looking up dApps indexed by Zapper
- —Building agent-driven crypto research workflows that need entity resolution
Fit
Best for
- —AI agents that need to resolve token symbols to contract addresses before making other onchain calls
- —Portfolio dashboards that need search-as-you-type for tokens and NFTs
- —Chatbots answering questions about crypto assets, users, or dApps
Not for
- —Full-text search of transaction data or block contents
- —Off-chain or traditional web search
- —Free/unauthenticated bulk data scraping
Quick start
curl -X POST https://public.zapper.xyz/x402/search \
-H 'Content-Type: application/json' \
-H 'X-Payment: <x402-payment-token>' \
-d '{"search": "USDC", "categories": ["ERC20_TOKEN"], "maxResultsPerCategory": 5}'Example
Request
{
"search": "USDC",
"categories": [
"ERC20_TOKEN"
],
"maxResultsPerCategory": 5
}Response
{
"data": {
"searchV2": {
"results": [
{
"name": "USD Coin",
"erc20": {
"decimals": 6,
"networkV2": {
"name": "Base"
}
},
"symbol": "USDC",
"address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"category": "ERC20_TOKEN",
"decimals": 6,
"imageUrl": "https://example.com/usdc.png"
}
]
}
}
}Endpoint
Quality
Full OpenAPI schema with input/output descriptions, live 402 challenge confirmed, clear pricing ($0.0045/call in Base USDC), and example request/response shapes provided. Docked slightly because no actual 200 response sample was captured and the legacy docs page is deprecated with no replacement crawlable docs.
Warnings
- —Legacy Zapper API docs at /api show a deprecation notice directing users to build.zapper.xyz; the x402 endpoints appear to be the replacement but no standalone documentation site was crawlable.
- —Example response is inferred from the output schema in the OpenAPI spec, not from an actual captured 200 response.
Citations
- —The search endpoint costs 4500 base units of USDC on Base (chain 8453), equaling $0.0045 per call.https://public.zapper.xyz/x402/search
- —Zapper API provides onchain data across 60+ chains — token prices, NFTs, portfolios, transactions, and more.https://public.zapper.xyz/x402/search
- —Searchable categories include ERC20_TOKEN, GAS_TOKEN, NFT_COLLECTION, USER, and APP.https://public.zapper.xyz/x402/search
- —The legacy Zapper API at /api shows a deprecation notice directing to build.zapper.xyz.https://public.zapper.xyz/api