Zerion

Zerion

This connector reads onchain wallet data from the Zerion API (https://api.zerion.io/v1) for EVM chains and Solana: portfolio value, token and DeFi positions, decoded transactions, profit and loss, balance charts, NFTs, token prices and charts, chains and gas prices. Everything is read-only: nothing is signed or sent, and the swap, webhook-subscription and wallet-set endpoints are not part of this connector.

Setup (2 minutes)

1. Sign up at https://dashboard.zerion.io and create an API key (a free developer plan exists).
2. Paste the key into ZERION_API_KEY. Zerion takes it as HTTP Basic auth: the key is the user name and the password stays empty.
3. Run zerion_list_chains to check the key.

Workflow

• What a wallet holds: zerion_get_wallet_portfolio for the totals by type and chain, zerion_list_wallet_positions for each token (set positions: no_filter to include DeFi positions such as lending, staking and liquidity, or only_complex for DeFi only).
• History: zerion_list_wallet_transactions (filter by chain, operation type, token or time), zerion_get_wallet_chart for the balance over time, zerion_get_wallet_pnl for realized and unrealized gains.
• NFTs (EVM wallets): zerion_list_wallet_nft_positions, zerion_list_wallet_nft_collections, zerion_get_wallet_nft_portfolio.
• Tokens: zerion_list_fungibles with search_query to find a token and its fungible id, then zerion_get_fungible or zerion_get_fungible_chart; zerion_get_fungible_by_implementation when you have a chain and contract address.
• Chains and fees: zerion_list_chains, zerion_get_chain, zerion_list_gas_prices.

Reading the answers: responses follow JSON:API: data holds the items, each with id, attributes and relationships (chain and fungible ids). Quantities come as quantity.float (human units) next to the raw integer. Values and prices are in the requested currency (USD by default). Times in mined_at and updated_at are ISO 8601; chart points are [unix_seconds, value]; time filters (min_mined_at, since, ...) take Unix milliseconds.

Paging: list tools return links.next when more items exist. Take the page[after] value out of that URL and pass it as page_after; stop when links.next is missing.

Filters that take several values (chain_ids, fungible_ids, operation_types, ...) are comma-separated, without spaces.

Limits: requests per second, per day and per month depend on the plan (the free Developer plan allows 2,000 requests a day at 3 per second; see the Dashboard). Positions with only_complex or no_filter, wallet charts and PnL count toward an advanced quota of 25% of the monthly requests; when it is used up those calls answer 429 while the others keep working. The NFT tools may first answer 202 while a wallet's NFTs are being indexed: wait a few seconds and ask again.

Errors: 401 means a wrong key, 400 an invalid address or filter (PnL and transactions also refuse contract and exchange hot-wallet addresses), 429 a rate limit or quota.