B
Zapper API
Preview responses and set spending limits for this service through use.mpp.land
Free budget controls, response samples, and reliability routing.
Compliance Checks
All paid ops declare 402 response
MUST
10pt
All x-payment-info valid
MUST
10pt
Challenge has Cache-Control: no-store
MUST
5pt
Challenge digest on POST
SHOULD
3pt
Challenge has expires
SHOULD
3pt
Challenge has Problem Details
SHOULD
2pt
Challenge has required params
MUST
5pt
Challenge has WWW-Authenticate
MUST
5pt
Challenge returns 402
MUST
10pt
Correct Content-Type
MUST
5pt
Has Cache-Control on discovery
SHOULD
5pt
Has input schemas
SHOULD
5pt
Has llms.txt
SHOULD
5pt
Has /openapi.json at root
MUST
10pt
Has required top-level fields
MUST
10pt
Served over HTTPS
MUST
10pt
Uses standard categories
SHOULD
2pt
1 issue
- POST endpoint challenge missing digest parameter (SHOULD per spec)
Paid Operations (17)
POST /x402/token-price dynamic
Get real-time token price and market cap
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | The 0x contract address |
| chainId | integer | Yes | The Chain ID (e.g. 8453 for Base) |
| currency | string | No |
Currency for price data (default: USD)
default: USD
|
POST /x402/search dynamic
Search for ERC20 tokens, NFTs, Users, Apps, or Gas Tokens.
- Amount
- 0.004500
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.004500 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| categories | array | No |
Filter results by category. Use multiple categories for broader results (e.g., ["GAS_TOKEN", "ERC20_TOKEN"] for all token types). Defaults to ERC20_TOKEN only.
default: [ERC20_TOKEN]
|
| maxResultsPerCategory | integer | No |
Limit results per category
default: 5
|
| search | string | Yes | Search query (e.g., "Ape", "eth", "Vitalik"). Searches for token SYMBOLS, NFT collection names, ENS, and BaseNames. |
POST /x402/nft-token-metadata dynamic
Get detailed metadata, traits, media, and holder info for a specific NFT
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| chainId | integer | Yes | The Chain ID (e.g. 1 for Mainnet, 8453 for Base) |
| collectionAddress | string | Yes | The 0x contract address of the collection |
| tokenId | string | Yes | The specific token ID to fetch metadata for |
POST /x402/nft-collection-metadata dynamic
Get NFT collection data including market stats, holders, events, and a sample of NFTs.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| collections | array | Yes | Array of collection inputs containing address and chainId |
POST /x402/portfolio-totals dynamic
Get aggregated portfolio totals (Tokens, Apps, NFTs) broken down by network for a single address, or a list of addresses.
- Amount
- 0.001875
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001875 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| addresses | array | Yes | Array of 0x wallet addresses to aggregate |
| chainIds | array | No | Optional list of Chain IDs to filter by (e.g. [1, 8453]) |
POST /x402/token-balances dynamic
Get detailed token balances for a single address, or a list of addresses, optionally filtering by chain.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| addresses | array | Yes | Array of 0x wallet addresses to aggregate |
| chainIds | array | No | Optional list of Chain IDs to filter by (e.g. [1, 8453]) |
| first | integer | No |
Number of tokens to return (max 20)
default: 10
|
POST /x402/defi-balances dynamic
Get DeFi balances (Liquidity Pools, Yield Farming, Lending, etc.) for a single address, or a list of addresses.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| addresses | array | Yes | Array of 0x wallet addresses to aggregate |
| chainIds | array | No | Optional list of Chain IDs to filter by |
| first | integer | No |
Number of DeFi positions to return (max 50)
default: 10
|
POST /x402/nft-balances dynamic
Get individual NFT balances and estimated values for a single address, or a list of addresses.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| addresses | array | Yes | Array of 0x wallet addresses to scan |
| chainIds | array | No | Optional list of Chain IDs to filter by |
| first | integer | No |
Number of NFTs to return
default: 10
|
| sortBy | string | No |
Sort order for results (e.g. "USD_WORTH", "NETWORK", "COLLECTION")
default: USD_WORTH
|
POST /x402/historical-token-price dynamic
Get the price of a token at a specific point in time.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | The 0x contract address of the token |
| chainId | integer | Yes | The Chain ID (e.g. 8453 for Base) |
| currency | string | No |
Currency for price data (default: USD)
default: USD
|
| timestamp | integer | Yes | The unix timestamp (in milliseconds) for the historical lookup |
POST /x402/transaction-details dynamic
Get human-readable interpretation, metadata, and balance changes for a specific transaction.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| chainId | integer | Yes | The Chain ID where the transaction occurred |
| hash | string | Yes | The transaction hash (0x...) |
POST /x402/transaction-history dynamic
Get transaction history with interpretations and metadata for a single address, or a list of addresses.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| after | string | No | Cursor for pagination |
| chainIds | array | No | Optional list of Chain IDs to filter by |
| first | integer | No |
Number of transactions to return
default: 10
|
| perspective | string | No |
Transaction perspective filter (e.g. "All", "Signer", "Receiver")
default: All
|
| subjects | array | Yes | Array of 0x wallet addresses to get transaction history for |
POST /x402/token-holders dynamic
Get token holders with balances and identity information for a specific token.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Token contract address (0x...) |
| after | string | No | Cursor for pagination |
| chainId | integer | Yes | Chain ID of the network (e.g. 1 for Ethereum, 8453 for Base) |
| first | number | Yes | Number of holders to return |
POST /x402/token-ranking dynamic
Get a ranked list of tokens based on swap activity and velocity of adoption, optionally tailored for a farcaster user.
- Amount
- 0.004500
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.004500 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| after | string | No | Cursor for pagination (get results after this cursor) |
| fid | integer | No | Optional Farcaster ID (FID) to personalize ranking |
| first | integer | No |
Number of items to return (pagination limit)
default: 10
|
POST /x402/nft-ranking dynamic
Get a ranked list of NFT collections based on rading activity and collection popularity, optionally tailored for a farcaster user.
- Amount
- 0.004500
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.004500 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| after | string | No | Cursor for pagination (get results after this cursor) |
| fid | integer | No | Optional Farcaster ID (FID) to personalize ranking |
| first | integer | No |
Number of items to return (pagination limit)
default: 10
|
POST /x402/account-identity dynamic
Get social identity (ENS, Farcaster, Lens, Basenames) for a specific address.
- Amount
- 0.001125
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.001125 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | The 0x wallet address to resolve identity for |
POST /x402/general-swap-feed dynamic
Get a real-time feed of swap activity across Farcaster, including token trades, volume, and social context.
- Amount
- 0.003750
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.003750 pricingMode: fixed protocols: [x402 mpp]
Input Schema
{
"type": "object"
}
POST /x402/token-activity-feed dynamic
Get a combined activity feed for a specific token, including swaps and top Farcaster casts, personalized for a given user.
- Amount
- 0.003750
- Currency
- -
- Method
- x402, mpp
- Intent
- -
- 402 Declared
- Yes
Non-standard x-payment-info fields:
price: 0.003750 pricingMode: fixed protocols: [x402 mpp]
Input Schema
| Field | Type | Required | Description |
|---|---|---|---|
| chainId | integer | Yes | Chain ID of the token (e.g. 8453 for Base) |
| fid | integer | No | Optional Farcaster ID (FID) to personalize the feed |
| filters | object | No | Optional filters such as minimumUsdVolume |
| tokenAddress | string | Yes | Contract address of the token |
| type | string | No | Feed type (e.g. DEFAULT) |
Payment Methods
- Methods
- tempo (from challenge)
- Intents
- charge (from challenge)
- Currencies (discovery)
- -
- Currency (challenge)
- USDC.e on Tempo (Tempo)
- Multiple Challenges
- No
Recipients
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
Per-endpoint breakdown
- POST /x402/nft-collection-metadata
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
- POST /x402/nft-token-metadata
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
- POST /x402/portfolio-totals
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
- POST /x402/search
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
- POST /x402/token-balances
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
- POST /x402/token-price
- 0x43a2a720cd0911690c248075f4a29a5e7716f758
Security
- TLS Version
- TLSv1.3
- Challenge ID Unique
- Yes
- Challenge ID Length
- 36
- Digest Binding
- -
Uptime
- Discovery
- Reachable (218ms)
- Challenge
- Reachable (362ms)
- Last Checked
Schema Completeness
- Paid Operations
- 17
- With Input Schema
- 17
- With Description
- 17
Documentation
- Homepage
- -
- API Reference
- -
- llms.txt
- -
Discovery
- OpenAPI URL
- https://public.zapper.xyz/openapi.json
- OpenAPI Version
- 3.1.0
- Service Version
- 1.0.0
- Document Size
- 44603 bytes
- Document Hash
- e13d67efaabc449d9070144137dcb5a1b60c2bae498e87d2a36fd78bcce32269
Version History (2 snapshots)
Scan snapshots
| Date | Grade | Score | Response | Status |
|---|---|---|---|---|
| 2026-04-06 | B | 79% | 245ms | Up |
| 2026-04-07 | B | 79% | 212ms | Up |