# Zerion API

> Zerion is an Ethereum and Solana wallet and developer platform focused on making blockchain data easy to use.

- [Introduction to Zerion API](https://developers.zerion.io/introduction.md): Zerion API is a REST API for onchain wallet data: portfolios, DeFi positions, NFTs, transactions, PnL, prices, and swaps across EVM chains and Solana.
- [Quickstart](https://developers.zerion.io/quickstart.md): Get a Zerion API key from the Dashboard and make your first authenticated wallet portfolio request with curl, JavaScript, or Python code samples.
- [Authentication](https://developers.zerion.io/authentication.md): Authenticate Zerion API requests with an API key using HTTP Basic Auth, including header format, environments, and code samples in curl, JavaScript, and Python.
- [Build AI agents with onchain data](https://developers.zerion.io/build-with-ai/overview.md): Connect AI agents and assistants to wallet portfolios, DeFi positions, transactions, and token prices with Zerion API, the MCP server, x402, and MPP payments.
- [Zerion CLI and agent skills for AI coding tools](https://developers.zerion.io/build-with-ai/zerion-cli.md): Analyze wallets, sign, swap, and bridge across EVM chains and Solana from the command line, plus agent skills that ship across every major AI coding agent.
- [x402 payments: pay-per-request Zerion API access](https://developers.zerion.io/build-with-ai/x402.md): Call Zerion API without an API key by paying per request in USDC on Base or Solana with the x402 protocol. No signup, rate limits, or monthly plan needed.
- [MPP payments: pay-per-request Zerion API access](https://developers.zerion.io/build-with-ai/mpp.md): Call Zerion API without an API key by paying per request in USDC on Tempo with the Machine Payments Protocol. No signup, rate limits, or monthly plan.
- [Model Context Protocol (MCP) server](https://developers.zerion.io/build-with-ai/mcp.md): Connect Claude, Cursor, and other AI coding tools to Zerion API docs through the Model Context Protocol server for in-editor answers and code generation.
- [Migrate to Zerion API](https://developers.zerion.io/migrate-to-zerion.md): Move your wallet data integration to Zerion API with endpoint mappings and code samples for Zapper, Dune, Mobula, DeBank, GoldRush, and Moralis.
- [Supported blockchains and chain IDs for Zerion API](https://developers.zerion.io/supported-blockchains.md): Reference list of mainnet and testnet blockchains supported by Zerion API, with chain IDs and coverage for tokens, transactions, and NFTs.
- [Endpoints and response schema](https://developers.zerion.io/endpoints-and-schema.md): Overview of Zerion API endpoint categories for wallets, chains, fungibles, NFTs, and swaps, plus the JSON:API response envelope and resource object structure.
- [Pagination, filtering, sorting, and currency](https://developers.zerion.io/pagination-and-filtering.md): Paginate through results with cursors, filter by chain, position type, or asset, sort responses, and switch currencies across Zerion API endpoints.
- [Error handling and status codes](https://developers.zerion.io/error-handling.md): Understand Zerion API error responses, HTTP status codes, rate-limit errors, and best practices for retry logic and exponential backoff in production apps.
- [Rate limits and throttling](https://developers.zerion.io/rate-limits.md): How Zerion API rate limits work, which response headers to inspect, how to detect 429 responses, and best practices for retries with exponential backoff.
- [Webhooks for real-time wallet transaction notifications](https://developers.zerion.io/webhooks.md): Subscribe to wallet activity and receive real-time webhook callbacks the moment a watched wallet sends or receives a transaction on EVM chains or Solana.
- [Kafka streaming for onchain events](https://developers.zerion.io/streaming.md): Subscribe to real-time onchain event streams from Zerion API over Kafka for high-throughput data pipelines, indexers, and internal analytics workloads.
- [Spam token filtering](https://developers.zerion.io/spam-filtering.md): How Zerion detects and filters spam and scam tokens across wallet positions, transactions, and NFTs, and how to opt in or out of trust filtering per request.
- [Real-world asset (RWA) classification](https://developers.zerion.io/rwa-classification.md): Identify tokenized stocks, treasuries, commodities, and stablecoins with the asset_class attribute on Zerion's fungibles and positions endpoints.
- [Migrate from Zapper to Zerion API](https://developers.zerion.io/migrate-from-zapper.md): A 1:1 mapping from Zapper's GraphQL API to Zerion API, covering portfolio balances, DeFi positions, transaction history, NFTs, and token prices.
- [Migrate from Dune SIM to Zerion API](https://developers.zerion.io/migrate-from-sim.md): A 1:1 mapping from Dune SIM endpoints to Zerion API, covering Balances, Activity, and DeFi Positions, with side-by-side code samples.
- [Migrate from Mobula to Zerion API](https://developers.zerion.io/migrate-from-mobula.md): Map Mobula wallet and market endpoints to Zerion API equivalents for holdings, net worth, activity, trades, PnL, NFTs, and prices, with code samples.
- [Migrate from OneBalance to Zerion API](https://developers.zerion.io/migrate-from-onebalance.md): Map OneBalance backend endpoints to Zerion API for wallet data, covering aggregated balances, transaction history, and asset list, with side-by-side code.
- [Migrate from DeBank Cloud to Zerion API](https://developers.zerion.io/migrate-from-debank.md): A 1:1 mapping from the DeBank Cloud API to Zerion API, covering token balances, net worth, DeFi positions, wallet history, and NFTs with side-by-side code.
- [Migrate from Allium to Zerion API](https://developers.zerion.io/migrate-from-allium.md): Map Allium Realtime Developer APIs to Zerion API endpoints for token balances, transactions, DeFi positions, PnL, and prices, with code samples.
- [Migrate from GoldRush (Covalent) to Zerion API](https://developers.zerion.io/migrate-from-goldrush.md): Migrate from GoldRush (Covalent) to Zerion API with endpoint mappings for token balances, transactions, prices, NFTs, DeFi positions, and PnL.
- [Migrate from Moralis to Zerion API](https://developers.zerion.io/migrate-from-moralis.md): Map Moralis Web3 Data API endpoints to Zerion API equivalents for token balances, net worth, wallet history, PnL, DeFi positions, and prices, with code samples.
- [Get wallet balance chart](https://developers.zerion.io/api-reference/wallets/get-wallet-balance-chart.md): Portfolio value over time for a wallet, filterable by chain and asset type, over any start and end timestamp.
- [Get wallet PnL](https://developers.zerion.io/api-reference/wallets/get-wallet-pnl.md): Realized and unrealized PnL for a wallet, FIFO-based, with net invested and per-asset-category filters.
- [Get wallet portfolio](https://developers.zerion.io/api-reference/wallets/get-wallet-portfolio.md): A wallet's total portfolio value, broken down by chain and position type.
- [Get wallet fungible positions](https://developers.zerion.io/api-reference/wallets/get-wallet-fungible-positions.md): A wallet's token balances and DeFi positions across every supported chain, priced and ready to render.
- [Get wallet transactions](https://developers.zerion.io/api-reference/wallets/get-wallet-transactions.md): Decoded transaction history for a wallet, with transfers, approvals, fees and dapp context.
- [Get wallet NFT positions](https://developers.zerion.io/api-reference/wallets/get-wallet-nft-positions.md): Every NFT a wallet holds, with media, traits, collection and floor price.
- [Get wallet NFT collections](https://developers.zerion.io/api-reference/wallets/get-wallet-nft-collections.md): The NFT collections a wallet holds, with per-collection holdings count and floor price.
- [Get wallet NFT portfolio](https://developers.zerion.io/api-reference/wallets/get-wallet-nft-portfolio.md): Aggregate NFT portfolio value for a wallet, totalled from floor prices across chains.
- [Get wallet set balance chart](https://developers.zerion.io/api-reference/wallet-sets/get-wallet-set-balance-chart.md): Combined portfolio value over time for an EVM and Solana address, filterable by chain and asset type.
- [Get wallet set PnL](https://developers.zerion.io/api-reference/wallet-sets/get-wallet-set-pnl.md): Realized and unrealized PnL across an EVM and Solana address combined, FIFO-based.
- [Get wallet set portfolio](https://developers.zerion.io/api-reference/wallet-sets/get-wallet-set-portfolio.md): Combined portfolio value for an EVM and Solana address, broken down by chain and position type.
- [Get wallet set fungible positions](https://developers.zerion.io/api-reference/wallet-sets/get-wallet-set-fungible-positions.md): Token balances and DeFi positions across an EVM and Solana address, returned as one combined set.
- [Get wallet set transactions](https://developers.zerion.io/api-reference/wallet-sets/get-wallet-set-transactions.md): Decoded transaction history across an EVM and Solana address, merged into one timeline.
- [Get list of fungible assets](https://developers.zerion.io/api-reference/fungibles/get-list-of-fungible-assets.md): Search and filter the token catalog Zerion supports, with prices, market data and per-chain implementations.
- [Get fungible asset by ID](https://developers.zerion.io/api-reference/fungibles/get-fungible-asset-by-id.md): Metadata, current price and market data for a single token, by its Zerion fungible ID.
- [Get a chart for a fungible asset](https://developers.zerion.io/api-reference/fungibles/get-a-chart-for-a-fungible-asset.md): Historical price chart for a token over a selected period, by Zerion fungible ID.
- [Get fungible asset by implementation](https://developers.zerion.io/api-reference/fungibles/get-fungible-asset-by-implementation.md): Look up a token by chain and contract address, without knowing its Zerion fungible ID.
- [Get a chart for a fungible asset by implementation](https://developers.zerion.io/api-reference/fungibles/get-a-chart-for-a-fungible-asset-by-implementation.md): Historical price chart for a token, addressed by chain and contract address instead of Zerion fungible ID.
- [Get list of all chains](https://developers.zerion.io/api-reference/chains/get-list-of-all-chains.md): Every chain Zerion API supports, with the chain IDs, icons, native assets and feature flags used by all other endpoints.
- [Get chain by ID](https://developers.zerion.io/api-reference/chains/get-chain-by-id.md): Look up one supported chain by its chain ID, with name, icon, native asset and per-chain feature flags.
- [Get swap and bridge quotes](https://developers.zerion.io/api-reference/swap/get-swap-and-bridge-quotes.md): Compare same-chain swap and cross-chain bridge quotes from multiple DEXs, aggregators and bridges, best first.
- [List fungibles available for bridging](https://developers.zerion.io/api-reference/swap/list-fungibles-available-for-bridging.md): List the tokens available for bridging between two chains, for populating a token picker.
- [Get list of all available gas prices](https://developers.zerion.io/api-reference/gas/get-list-of-all-available-gas-prices.md): Real-time gas price estimates for every supported chain, at each speed tier.
- [Get list of NFTs](https://developers.zerion.io/api-reference/nfts/get-list-of-nfts.md): Batch-look up NFTs by reference, covering both ERC-721 and ERC-1155, with media and traits.
- [Get single NFT by ID](https://developers.zerion.io/api-reference/nfts/get-single-nft-by-id.md): Look up one NFT by its unique ID, with media, traits and collection context.
- [Get list of DApps](https://developers.zerion.io/api-reference/dapps/get-list-of-dapps.md): Browse dapp metadata (names, icons, categories) used to label DeFi positions and transactions.
- [Get DApp by ID](https://developers.zerion.io/api-reference/dapps/get-dapp-by-id.md): Look up one dapp by its ID, with the name and icon used to label DeFi positions and transactions.
- [Find subscriptions](https://developers.zerion.io/api-reference/subscriptions-to-transactions/find-subscriptions.md): List your webhook subscriptions, filtered by wallet or chain.
- [Create subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/create-subscription.md): Create a webhook subscription that pushes transaction notifications for a set of wallets to your callback URL.
- [Find subscription by ID](https://developers.zerion.io/api-reference/subscriptions-to-transactions/find-subscription-by-id.md): Fetch one webhook subscription by ID, with the wallets and chains it monitors and its callback URL.
- [Delete subscription by ID](https://developers.zerion.io/api-reference/subscriptions-to-transactions/delete-subscription-by-id.md): Permanently delete a webhook subscription and stop notifications for all of its wallets.
- [Find wallets within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/find-wallets-within-subscription.md): List the wallet addresses a webhook subscription currently monitors.
- [Replace wallets within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/replace-wallets-within-subscription.md): Replace the entire wallet list of a webhook subscription in one call.
- [Patch wallets within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/patch-wallets-within-subscription.md): Add or remove wallets in a webhook subscription without resending the whole list.
- [Count wallets within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/count-wallets-within-subscription.md): Count how many wallets a webhook subscription currently monitors.
- [Update callback URL within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/update-callback-url-within-subscription.md): Point an existing webhook subscription at a new callback URL.
- [Enable a specific subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/enable-a-specific-subscription.md): Resume a paused webhook subscription and start receiving notifications again.
- [Disable a specific subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/disable-a-specific-subscription.md): Pause a webhook subscription without deleting it or losing its wallet list.
- [Update chain IDs within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/update-chain-ids-within-subscription.md): Change which chains a webhook subscription monitors, replacing the current chain list.
- [Update filters within subscription](https://developers.zerion.io/api-reference/subscriptions-to-transactions/update-filters-within-subscription.md): Replace or clear the event filters on an existing webhook subscription.
- [Step-by-step guides for common Zerion API tasks](https://developers.zerion.io/recipes.md): Task-focused guides for building portfolio trackers, NFT viewers, PnL dashboards, transaction feeds, swap flows, and wallet alerts with Zerion API.
- [Build a multi-chain portfolio tracker](https://developers.zerion.io/recipes/multi-chain-portfolio.md): Fetch a wallet's total value and token holdings, aggregate multiple wallets, compare across chains, and chart performance over time with Zerion API.
- [Get a wallet's DeFi positions](https://developers.zerion.io/recipes/defi-positions.md): Retrieve lending, staking, liquidity, and farming positions across DeFi protocols for any wallet, grouped by protocol and chain, using Zerion API.
- [Get a wallet's transaction history](https://developers.zerion.io/recipes/transaction-history.md): Fetch and interpret a wallet's onchain transactions across chains with human-readable types, transfer details, and fee breakdowns using Zerion API.
- [Set up wallet activity alerts](https://developers.zerion.io/recipes/wallet-activity-alerts.md): Use Zerion API transaction subscriptions and webhooks to get real-time notifications when a watched wallet sends or receives tokens across supported chains.
- [Build a wallet PnL tracker](https://developers.zerion.io/recipes/wallet-pnl-tracker.md): Track realized and unrealized gains, cost basis, ROI, and per-token performance for any wallet across EVM chains and Solana with Zerion API PnL endpoints.
- [Swap tokens and bridge assets](https://developers.zerion.io/recipes/swap-tokens.md): Get quotes and ready-to-sign transactions for same-chain swaps and cross-chain bridges across EVM chains and Solana with Zerion API swap endpoints.
- [Build an NFT portfolio viewer](https://developers.zerion.io/recipes/nft-portfolio.md): Fetch a wallet's NFT holdings across chains, group them by collection, and display floor prices, total value, and per-chain breakdowns with Zerion API.
- [Build an AI agent with onchain data](https://developers.zerion.io/recipes/ai-agent-integration.md): Give your AI agent access to wallet portfolios, token prices, and transaction history through Zerion API tool calls with a step-by-step OpenAI-style example.
- [Changelogs](https://developers.zerion.io/changelog.md): Release notes for the Zerion API covering new blockchain support, endpoint changes, documentation updates, and other feature and bug-fix announcements.

## OpenAPI Specs

- [openapi-v1](/openapi-v1.yaml)

## Optional

- [Dashboard](https://dashboard.zerion.io)
- [Case studies](https://zerion.io/blog/tag/zerion-api/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.