Get a wallet's transaction history

What you’ll build

A transaction feed with human-readable labels
Filters by type, chain and date range
Pagination through a wallet’s full history

Time

~10 minutes

You need

A Zerion API key
A wallet address to query

Endpoints

GET/v1/wallets/address/transactions/

Steps

Fetch recent transactions

Call wallet transactions to get a wallet’s most recent transactions.

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

const response = await fetch(
  `https://api.zerion.io/v1/wallets/${address}/transactions/?currency=usd&page[size]=10`,
  { headers }
);
if (!response.ok) throw new Error(`API error: ${response.status}`);

const { data } = await response.json();

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

  console.log(`[${mined_at}] ${operation_type} on ${chain}`);
  if (application_metadata?.name) {
    console.log(`  via ${application_metadata.name}`);
  }
  for (const transfer of transfers) {
    const symbol = transfer.fungible_info?.symbol || "NFT";
    console.log(
      `  ${transfer.direction === "out" ? "-" : "+"}${transfer.quantity.float} ${symbol} (${transfer.value != null ? `$${transfer.value.toFixed(2)}` : "N/A"})`
    );
  }
  console.log(`  Fee: ${fee.value != null ? `$${fee.value.toFixed(2)}` : "N/A"}`);
}

import os, requests

api_key = os.environ["ZERION_API_KEY"]
address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

response = requests.get(
    f"https://api.zerion.io/v1/wallets/{address}/transactions/",
    params={"currency": "usd", "page[size]": 10},
    auth=(api_key, ""),
)

for tx in response.json()["data"]:
    attrs = tx["attributes"]
    chain = tx["relationships"]["chain"]["data"]["id"]
    app = attrs.get("application_metadata", {})

    print(f"[{attrs['mined_at']}] {attrs['operation_type']} on {chain}")
    if app.get("name"):
        print(f"  via {app['name']}")
    for transfer in attrs["transfers"]:
        symbol = transfer.get("fungible_info", {}).get("symbol", "NFT")
        direction = "-" if transfer["direction"] == "out" else "+"
        val = transfer.get("value")
        print(f"  {direction}{transfer['quantity']['float']} {symbol} ({f'${val:.2f}' if val is not None else 'N/A'})")
    fee_val = attrs["fee"].get("value")
    print(f"  Fee: {f'${fee_val:.2f}' if fee_val is not None else 'N/A'}")

curl -g -u "YOUR_API_KEY:" \
  "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions/?currency=usd&page[size]=10"

Each transaction includes:

operation_type - The high-level action, such as trade, send, receive or deposit.
transfers[] - Individual token movements, each with a direction (in, out or self).
fee - The gas fee paid, with its USD value.
application_metadata - The DApp involved (for example, Uniswap or Aave).

Filter by operation type

Pass filter[operation_types] to return only certain transaction types.

# Show only trades (swaps)
curl -g -u "YOUR_API_KEY:" \
  "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions/?currency=usd&filter[operation_types]=trade"

Available operation types:

Type	Description
`send`	Sent tokens to another address
`receive`	Received tokens from another address
`trade`	Swapped tokens (for example, on a DEX)
`deposit`	Deposited into a DeFi protocol
`withdraw`	Withdrew from a DeFi protocol
`mint`	Minted new tokens
`burn`	Burned tokens
`approve`	Approved token spending
`claim`	Claimed rewards or airdrops
`execute`	Generic smart contract interaction
`deploy`	Deployed a smart contract

Filter by chain and date range

Narrow results to specific chains with filter[chain_ids], or to a time window with filter[min_mined_at]. The filter[min_mined_at] value is a Unix timestamp in milliseconds.

# Ethereum transactions since Feb 26, 2024 (1708905600000 ms)
curl -g -u "YOUR_API_KEY:" \
  "https://api.zerion.io/v1/wallets/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions/?currency=usd&filter[chain_ids]=ethereum&filter[min_mined_at]=1708905600000"

Paginate through the full history

Each response has a links.next URL. Follow it until it’s empty to fetch every page.

async function getFullHistory(address) {
  const allTxs = [];
  let url = `https://api.zerion.io/v1/wallets/${address}/transactions/?currency=usd&page[size]=100`;

  while (url) {
    const response = await fetch(url, {
      headers,
    });
    const result = await response.json();
    allTxs.push(...result.data);
    url = result.links.next || null;
  }

  return allTxs;
}

def get_full_history(address):
    all_txs = []
    url = f"https://api.zerion.io/v1/wallets/{address}/transactions/"
    params = {"currency": "usd", "page[size]": 100}

    while url:
        response = requests.get(url, params=params, auth=(api_key, ""))
        result = response.json()
        all_txs.extend(result["data"])
        url = result["links"].get("next")
        params = {}  # params are included in the next URL

    return all_txs

Full working example

Save as tx-history.mjs and run with node tx-history.mjs:

const API_KEY = process.env.ZERION_API_KEY;
const BASE_URL = "https://api.zerion.io/v1";
const headers = {
  accept: "application/json",
  authorization: `Basic ${btoa(API_KEY + ":")}`,
};

async function getTransactions(address, { types, chains, limit } = {}) {
  const params = new URLSearchParams({ currency: "usd", "page[size]": limit || 20 });
  if (types) params.set("filter[operation_types]", types);
  if (chains) params.set("filter[chain_ids]", chains);

  const res = await fetch(
    `${BASE_URL}/wallets/${address}/transactions/?${params}`,
    { headers }
  );
  return res.json();
}

async function displayHistory(address) {
  const { data } = await getTransactions(address, { limit: 10 });

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

    console.log(`[${mined_at}] ${operation_type} on ${chain}`);
    if (application_metadata?.name) {
      console.log(`  via ${application_metadata.name}`);
    }
    for (const transfer of transfers) {
      const symbol = transfer.fungible_info?.symbol || "NFT";
      const dir = transfer.direction === "out" ? "-" : "+";
      console.log(`  ${dir}${transfer.quantity.float} ${symbol} (${transfer.value != null ? `$${transfer.value.toFixed(2)}` : "N/A"})`);
    }
    console.log(`  Fee: ${fee.value != null ? `$${fee.value.toFixed(2)}` : "N/A"}\n`);
  }
}

displayHistory("0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045");

Next steps

Use filter[asset_types]=nft to show NFT transfers.
Combine with the DApps endpoint to enrich application_metadata.
Get real-time alerts with the webhook recipe instead of polling.

Set up wallet activity alerts Webhooks for every send, receive and swap. Webhooks Build a wallet PnL tracker Realized and unrealized gains, cost basis and per-token returns. PnL

​Steps

​Next steps

Steps

Next steps