Migrate from Allium to Zerion API

• One address, all chains: Allium takes a {chain, address} pair per wallet, so a multi-chain balance read means one entry per chain. Zerion returns every supported chain for an address in one call to /wallets/{address}/positions/, filterable with filter[chain_ids].
• One call for tokens + DeFi: Collapse Allium’s wallet/balances and wallet/positions into a single /positions/?filter[positions]=no_filter response.
• Values precomputed: Allium balances return raw_balance (and a token.price you multiply yourself). Zerion returns quantity.float and value (USD) per position, plus a portfolio breakdown by chain and type.

​

Endpoint parity

​

A note on request shape

• Allium: POST an array of {chain, address} objects. You pick the chain per wallet, and you can batch up to 100 wallets in one request.
• Zerion: GET /v1/wallets/{address}/... with the address in the path. One address per call, all supported chains by default, narrowed with filter[chain_ids]. To read many wallets in one request, use the wallet sets endpoints.

​

Token balances

const API_KEY = process.env.ZERION_API_KEY;
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";

const res = await fetch(
  `https://api.zerion.io/v1/wallets/${address}/positions/?currency=usd&filter[positions]=only_simple&filter[trash]=only_non_trash&sort=-value`,
  {
    headers: {
      accept: "application/json",
      authorization: `Basic ${btoa(API_KEY + ":")}`,
    },
  }
);
const { data } = await res.json();

for (const pos of data) {
  const { fungible_info, quantity, price, value } = pos.attributes;
  const chain = pos.relationships.chain.data.id;
  console.log(`${fungible_info.symbol} on ${chain}: ${quantity.float} @ $${price} = $${value?.toFixed(2) ?? "N/A"}`);
}

​

Field mapping

​

Transactions

const API_KEY = process.env.ZERION_API_KEY;
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
const headers = {
  accept: "application/json",
  authorization: `Basic ${btoa(API_KEY + ":")}`,
};

const res = await fetch(
  `https://api.zerion.io/v1/wallets/${address}/transactions/?currency=usd&page[size]=20`,
  { headers }
);
const { data } = await res.json();

for (const tx of data) {
  const { operation_type, mined_at, transfers, fee } = tx.attributes;
  const chain = tx.relationships.chain.data.id;
  const dappId = tx.relationships.dapp?.data?.id;

  console.log(`[${mined_at}] ${operation_type} on ${chain}`);
  if (dappId) console.log(`  via ${dappId}`);
  for (const t of transfers) {
    const sign = t.direction === "out" ? "-" : "+";
    const symbol = t.fungible_info?.symbol ?? "NFT";
    console.log(`  ${sign}${t.quantity.float} ${symbol} ($${t.value?.toFixed(2) ?? "?"})`);
  }
  console.log(`  Fee: $${fee.value?.toFixed(2) ?? "?"}`);
}

​

Field mapping

​

Filter mapping

​

DeFi positions

const API_KEY = process.env.ZERION_API_KEY;
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";

const res = await fetch(
  `https://api.zerion.io/v1/wallets/${address}/positions/?currency=usd&filter[positions]=only_complex&sort=-value`,
  { headers: { accept: "application/json", authorization: `Basic ${btoa(API_KEY + ":")}` } }
);
const { data } = await res.json();

for (const pos of data) {
  const { name, protocol, protocol_module, position_type, quantity, value } = pos.attributes;
  const chain = pos.relationships.chain.data.id;
  console.log(`[${position_type}] ${name} | ${protocol} (${protocol_module}) on ${chain}: ${quantity.float} = $${value?.toFixed(2) ?? "N/A"}`);
}

​

Field mapping

​

Holdings PnL

const API_KEY = process.env.ZERION_API_KEY;
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";

const res = await fetch(
  `https://api.zerion.io/v1/wallets/${address}/pnl?currency=usd`,
  { headers: { accept: "application/json", authorization: `Basic ${btoa(API_KEY + ":")}` } }
);
const { data } = await res.json();
const a = data.attributes;

console.log(`Realized gain:   $${a.realized_gain?.toFixed(2)}`);
console.log(`Unrealized gain: $${a.unrealized_gain?.toFixed(2)}`);
console.log(`Net invested:    $${a.net_invested?.toFixed(2)}`);
console.log(`Total fees:      $${a.total_fee?.toFixed(2)}`);

​

Field mapping

​

Token prices

const API_KEY = process.env.ZERION_API_KEY;
const implementation = "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"; // USDC

const res = await fetch(
  `https://api.zerion.io/v1/fungibles/by-implementation?implementation=${implementation}&currency=usd`,
  { headers: { accept: "application/json", authorization: `Basic ${btoa(API_KEY + ":")}` } }
);
const { data } = await res.json();
const m = data.attributes.market_data;

console.log(`${data.attributes.symbol}: $${m.price}`);
console.log(`24h change: ${m.changes?.percent_1d?.toFixed(2)}%`);

​

Field mapping

​

Pagination

async function getAll(url) {
  const all = [];
  const headers = { accept: "application/json", authorization: `Basic ${btoa(API_KEY + ":")}` };

  while (url) {
    const res = await fetch(url, { headers });
    const { data, links } = await res.json();
    all.push(...data);
    url = links?.next ?? null;
  }
  return all;
}

​

Realtime updates

​

Differences from Allium

• Non-EVM, non-Solana chains: Allium Realtime covers chains like Bitcoin, Stellar, NEAR, and Sui. Zerion covers EVM chains and Solana. Check the supported chains list for the ones you rely on.
• Perpetuals: Allium returns perp positions with leverage, mark price, and liquidation price. Zerion’s positions model does not return perpetuals.
• Per-token historical balance snapshots: Allium’s wallet/balances/history returns point-in-time token balances. Zerion exposes wallet value over time via /charts/{period} and asset price history via the fungible chart, but not a per-token balance-at-timestamp endpoint.
• OHLC price candles: Allium’s prices endpoint returns open/high/low/close per interval. Zerion returns live price plus a chart timeseries, not OHLC candles.
• Liquidity and holder analytics: Allium exposes total_liquidity_usd and holders_count on tokens. Zerion does not return pool liquidity or holder counts.

• Authentication: Allium uses an X-API-KEY header. Zerion uses HTTP Basic Auth. Get a key at dashboard.zerion.io.
• Request shape: Allium endpoints are POST with a JSON array of {chain, address} objects. Zerion endpoints are GET /v1/wallets/{address}/... with the address in the path. See the note above.
• One address spans all chains: Allium pairs each address with one chain. Zerion returns every supported chain for an address by default, narrowed with filter[chain_ids].
• Multiple wallets: Allium batches up to 100 wallets per call. Zerion reads one address per /wallets/ call; for batches use the wallet sets endpoints.
• Values precomputed: Allium balances return raw_balance and a token.price; you divide by 10^decimals and multiply. Zerion returns quantity.float and value (USD) per position.
• One endpoint for tokens and DeFi: Zerion serves both wallet tokens and DeFi positions from /positions/. Switch via filter[positions]=only_simple (wallet only), only_complex (DeFi only), or no_filter (both).
• Flattened DeFi: Allium returns typed positions with nested supplies/borrows/collateral. Zerion returns one row per position tagged with protocol_module and position_type (including loan for debt). Group by relationships.dapp.data.id to reconstruct protocols, and by group_id to reconstruct LP pairs.
• Chain IDs: Allium and Zerion both use lowercase string chain IDs (e.g. ethereum, solana), so most map 1:1. Confirm the longer-tail names against the full list.
• Response shape: Zerion uses JSON:API. Payloads live under data[].attributes with related entities under data[].relationships.
• Spam filtering: Allium gates dust with min_liquidity / with_liquidity_info. Zerion uses filter[trash]=only_non_trash. See spam filtering for the full taxonomy.
• Pagination: Allium pages with a cursor query parameter; Zerion returns a fully-formed links.next URL you can fetch as-is. See pagination.

​

Get in touch