Skip to content

Wallet transfers across chains

$0.01 per callUSDC via x402POST /api/wallet-transfers-multichain

A wallet's token and native transfers on up to 5 EVM networks in one call (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB, Celo, Gnosis, Arc and more), merged newest first by block time: network, block, time, hash, from, to, category, asset, exact decimal value, token contract and NFT token ids. Send POST /api/wallet-transfers-multichain with the required field address and pay $0.01 per call over x402 or MPP (there is no free tier). It returns a JSON object with address, networks, direction, categories, contracts and 16 more.

Filter by direction, category, token contracts and a time window; page with the cursor. Each network's state is in the answer, so a network that did not answer is never read as having no transfers.

Category: Crypto & onchain dataTags: crypto transfers multichain wallet history erc20 erc721 evm

Try in playground →

Parameters

NameTypeRequiredDescription
addressstringyes0x-prefixed 40-char EVM address. Also accepted as addr, wallet, account.
networksarray of stringnoUp to 5 of ethereum, base, polygon, arbitrum, optimism, bnb, celo, gnosis, arc, robinhood, monad, ronin (default ethereum, base, arbitrum, optimism, polygon).
directionstringnoin (received), out (sent) or both (default).
categoryarray of stringnoSubset of external, internal, erc20, erc721, erc1155, specialnft. Default external+erc20+erc721+erc1155.
contractsarray of stringnoOptional token contract filter, up to 10 addresses (token categories only).
fromTimestringnoWindow start, ISO 8601 (default: the start of chain history).
toTimestringnoWindow end, ISO 8601 (default: now).
maxCountnumbernoRows per call, 1-100 (default 25).
orderstringnodesc (newest first, default) or asc.
includeZeroValuebooleannoInclude zero-value transfers. Default false.
pageKeystringnoCursor from a previous response to fetch the next page.

Example request

curl -i -X POST https://agent402.tools/api/wallet-transfers-multichain \
  -H "Content-Type: application/json" \
  -d '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","networks":["ethereum","base","arbitrum"],"direction":"in","category":["external","erc20"],"maxCount":5}'

Without payment this returns HTTP 402 Payment Required with the exact price for wallet-transfers-multichain; any x402 v2 or MPP client pays it and retries.

Watch a call get paid

RequestPOST /api/wallet-transfers-multichain
402$0.01 USDC
SignPAYMENT-SIGNATURE
Settleon 14 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example response

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "networks": [
    "ethereum",
    "base",
    "arbitrum"
  ],
  "direction": "in",
  "categories": [
    "external",
    "erc20"
  ],
  "contracts": [],
  "fromTime": null,
  "toTime": null,
  "order": "desc",
  "maxCount": 5,
  "count": 1,
  "transfers": [
    {
      "network": "base",
      "blockNum": 35000000,
      "timestamp": "2026-11-19T20:01:02Z",
      "hash": "0x214b…e56b",
      "from": "0xa916…6081",
      "to": "0xd8da…6045",
      "category": "erc20",
      "asset": "USDC",
      "value": "0.42",
      "rawValue": "420000",
      "decimals": 6,
      "contract": "0x8335…2913",
      "tokens": null
    }
  ],
  "networkStatus": [
    {
      "network": "ethereum",
      "state": "ok"
    },
    {
      "network": "base",
      "state": "ok"
    },
    {
      "network": "arbitrum",
      "state": "ok"
    }
  ],
  "scanned": 3,
  "scanCandidates": 3,
  "scanCap": 5,
  "scanCoversAll": true,
  "complete": false,
  "truncated": true,
  "pageKey": "eyJvIjoxfQ",
  "source": "alchemy",
  "fetchedAt": "2026-11-20T12:00:00.000Z"
}
FieldTypeAlways presentIn the example
addressstringyes0xd8da6bf26964af9d7eed9e03e53415d37aa96045
networksarray of stringyes3 items in the example
directionstringyesin
categoriesarray of stringyes2 items in the example
contractsarrayyes0 items in the example
fromTimenullnonull
toTimenullnonull
orderstringyesdesc
maxCountnumberyes5
countnumberyes1
transfersarray of objectsyes1 item in the example
networkStatusarray of objectsyes3 items in the example
scannednumberyes3
scanCandidatesnumberyes3
scanCapnumberyes5
scanCoversAllbooleanyestrue
completebooleanyesfalse
truncatedbooleanyestrue
pageKeystringyeseyJvIjoxfQ
sourcestringyesalchemy
fetchedAtstringyes2026-11-20T12:00:00.000Z

From an MCP client

catalog.call {
  "slug": "wallet-transfers-multichain",
  "params": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "networks": [
      "ethereum",
      "base",
      "arbitrum"
    ],
    "direction": "in",
    "category": [
      "external",
      "erc20"
    ],
    "maxCount": 5
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for wallet-transfers-multichain; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.1.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.01" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/wallet-transfers-multichain", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "networks": [
      "ethereum",
      "base",
      "arbitrum"
    ],
    "direction": "in",
    "category": [
      "external",
      "erc20"
    ],
    "maxCount": 5
  }),
});

Related tools

Wallet token transfers (filtered)

$0.003POST /api/asset-transfers

Recent token transfers for a wallet on Base, Ethereum and other EVM chains, newest first.

Multi-chain EVM RPC (read-only)

$0.004POST /api/evm-rpc

Read-only JSON-RPC against Ethereum, Base, Polygon, Arbitrum, or Optimism with built-in multi-endpoint failover - one.

Token balances (named contracts)

$0.002POST /api/token-balances

ERC-20 balances of one wallet for a NAMED list of token contracts (1-20) - the targeted complement to the full-portfolio.

Wallet balance (native + ERC-20)

$0.002POST /api/wallet-balance

Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon.

Transaction receipt (decoded transfers)

$0.003POST /api/tx-receipt

Full receipt for a transaction hash in one call: status, block, from/to, value, gas used vs limit, effective gas price.

Wallet transaction history

$0.001POST /api/wallet-transactions

Return the most recent asset transfers (incoming + outgoing) for a wallet address - native coin, ERC-20, ERC-721.