Quickstart

Make your first request

Get your API key

Try it from the docs

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

Make a request from your code

The API uses HTTP Basic Auth. Your API key is the username, and the password is empty. To 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"

// Transform your API key for Basic Auth
const apiKey = 'YOUR_API_KEY';
const apiKeyTransformed = btoa(apiKey + ':');

// Make the request
const response = await fetch(
  'https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/portfolio',
  {
    headers: {
      'Authorization': `Basic ${apiKeyTransformed}`,
      'accept': 'application/json'
    }
  }
);
if (!response.ok) throw new Error(`API error: ${response.status}`);
const data = await response.json();
console.log(data);

import requests
import base64

# Transform your API key for Basic Auth
api_key = 'YOUR_API_KEY'
api_key_transformed = base64.b64encode(f'{api_key}:'.encode()).decode()

# Make the request
response = requests.get(
    'https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/portfolio',
    headers={
        'Authorization': f'Basic {api_key_transformed}',
        'accept': 'application/json'
    }
)
response.raise_for_status()
data = response.json()
print(data)

import (
    "encoding/base64"
    "log"
    "net/http"
)

// Transform your API key for Basic Auth
apiKey := "YOUR_API_KEY"
apiKeyTransformed := base64.StdEncoding.EncodeToString([]byte(apiKey + ":"))

// Make the request
client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/portfolio", nil)
if err != nil {
    log.Fatal(err)
}
req.Header.Set("Authorization", "Basic " + apiKeyTransformed)
req.Header.Set("accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

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.

Try another endpoint

Token positions Every token a wallet holds, with quantities and USD values.Transactions Decoded history, filterable by type, chain, and date.NFT positions NFT holdings with metadata and floor prices.Token search Find any token by name or address, with prices.Swap quotes Best swap and bridge offers across chains.Gas prices Current gas prices on every supported chain.

Next steps

Authentication API key encoding and security best practices.Pagination and 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.

Get started

Core concepts

Migrating to Zerion API

Make your first request

Try another endpoint

Next steps

​Make your first request

​Try another endpoint

​Next steps

Make your first request

Try another endpoint

Next steps