From Dune SIM

Documentation Index

Fetch the complete documentation index at: https://developers.zerion.io/llms.txt

Use this file to discover all available pages before exploring further.

• One call for wallet + DeFi: Collapse two SIM requests (balances + defi/positions) into a single /positions/?filter[positions]=no_filter response.
• Portfolio in one shot: Total value, 24h change, and chain breakdown without computing from balances.
• Solana on the same endpoints: Pass any EVM or Solana address to /wallets/{address}/... and get back the same enriched shape.

​

Endpoint parity

​

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

​

Wallet activity (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

​

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;
}

​

Webhooks (real-time updates)

​

Differences from SIM

• Token holders: SIM ranks ERC20 holders by balance via /v1/evm/token-holders. Not on Zerion today; pair with a separate data source if you need holder rankings.
• Raw RPC-style transactions: SIM’s /v1/evm/transactions returns raw block data (gas, calldata, logs). Zerion’s /transactions/ is enriched and decoded, not raw. For raw fields, use mined_at_block + hash from Zerion to look the transaction up via a node provider (Alchemy, Infura).
• Eclipse chain: Zerion supports Solana but not Eclipse SVM. Check the supported chains list before migrating Eclipse-dependent code.
• SVM-specific token-mint fields: SIM’s /beta/svm/balances/ returns Solana-specific fields like program_id (SPL token program), total_supply, and uri (token metadata URI). Zerion abstracts these away. Query a Solana RPC directly if you depend on them.

• Authentication: SIM uses an X-Sim-Api-Key header. Zerion uses HTTP Basic Auth. Get a key at dashboard.zerion.io.
• Chain IDs: SIM filters chains via numeric chain_ids (e.g. 1,8453). Zerion uses string chain IDs (e.g. ethereum,base). See the full list.
• Solana: SIM splits EVM and Solana into separate endpoint families (Solana lives at /beta/svm/... with a different schema) and only exposes raw RPC-style Solana transactions, no enriched activity. Zerion accepts Solana addresses on the same /wallets/{address}/... endpoints used for EVM, and returns the same enriched activity shape (operation_type, transfers[], fee) for both chains. DeFi positions are not yet supported for Solana.
• Pagination: SIM returns next_offset; Zerion returns a fully-formed links.next URL you can fetch as-is. See pagination.
• Response shape: Zerion uses JSON:API. Payloads live under data[].attributes with related entities under data[].relationships.
• Spam filtering: SIM has exclude_spam_tokens; Zerion uses filter[trash]=only_non_trash. See spam filtering for the full taxonomy.
• One endpoint for wallet and DeFi: Zerion serves both wallet tokens and DeFi positions from /positions/. Switch via filter[positions]=only_simple (wallet only) or only_complex (DeFi only).
• Stablecoin filter: SIM has asset_class=stablecoin. Zerion requires a comma-separated filter[fungible_ids]=… list. See the stablecoins note above.
• Supply / borrow split: Some SIM DeFi positions split a single lending position into separate supply and borrow rows. Zerion returns one row per position with position_type and the underlying token; reconstruct directions from quantity sign or position_type semantics.
• LP tick ranges and VeNFT lock metadata: SIM exposes raw LP tick ranges and vote-escrow lock dates. Zerion abstracts these away and surfaces the position’s USD value, underlying token, and protocol module.
• Pool size / low liquidity flags: SIM provides per-token pool_size and low_liquidity flags. Zerion’s spam classifier filters dust via filter[trash], but does not expose a numeric pool size.

​

Get in touch