Skip to main content

Get a wallet portfolio

Total value, position breakdown, and daily changes for any address.

List fungible positions

Every token a wallet holds with quantities and USD values.

View DeFi positions

Lending, staking, and liquidity positions across protocols.

NFT positions

NFT holdings with metadata, floor prices, and collection info.

​
Make your first request

1

Get your API key

Sign up at dashboard.zerion.io and create an API key from the dashboard. It’s free to start.
2

Try it from the docs

The fastest way to test the API is right here in the docs. Open any API reference page, click Try it, enter your API key in the Username field, leave Password empty, and hit Send.
3

Make a request from your code

The API uses HTTP Basic Auth — your API key is the username, password is empty. Let’s fetch a wallet portfolio:
# Transform your API key for Basic Auth
API_KEY_TRANSFORMED=$(echo -n "YOUR_API_KEY:" | base64)

# Make the request
curl -X GET "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/portfolio" \
  -H "Authorization: Basic $API_KEY_TRANSFORMED" \
  -H "accept: application/json"
4

Understand the response

The API returns data in JSON:API format. Every response has a data object with type, id, and attributes:
{
  "data": {
    "type": "portfolios",
    "id": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
    "attributes": {
      "positions_distribution_by_type": {
        "wallet": 0.85,
        "deposited": 0.10,
        "staked": 0.04,
        "locked": 0.01
      },
      "total": { "positions": 142 },
      "changes": {
        "absolute_1d": 1250.50,
        "percent_1d": 0.02
      }
    }
  }
}
List endpoints return a data array and support pagination.

​
Next steps

Authentication

API key encoding and security best practices.

Pagination & Filtering

Cursor pagination, filters, sorting, and currency options.

Recipes

Step-by-step guides for common use cases.

Rate Limits

Plan quotas, retry guidance, and usage headers.

Supported Blockchains

Full list of supported chains and feature coverage.