Wallet transfers across chains
POST /api/wallet-transfers-multichainA 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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
address | string | yes | 0x-prefixed 40-char EVM address. Also accepted as addr, wallet, account. |
networks | array of string | no | Up to 5 of ethereum, base, polygon, arbitrum, optimism, bnb, celo, gnosis, arc, robinhood, monad, ronin (default ethereum, base, arbitrum, optimism, polygon). |
direction | string | no | in (received), out (sent) or both (default). |
category | array of string | no | Subset of external, internal, erc20, erc721, erc1155, specialnft. Default external+erc20+erc721+erc1155. |
contracts | array of string | no | Optional token contract filter, up to 10 addresses (token categories only). |
fromTime | string | no | Window start, ISO 8601 (default: the start of chain history). |
toTime | string | no | Window end, ISO 8601 (default: now). |
maxCount | number | no | Rows per call, 1-100 (default 25). |
order | string | no | desc (newest first, default) or asc. |
includeZeroValue | boolean | no | Include zero-value transfers. Default false. |
pageKey | string | no | Cursor 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
POST /api/wallet-transfers-multichain$0.01 USDCPAYMENT-SIGNATUREon 14 chains200 OKAgent402-ReceiptEd25519Example 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"
}| Field | Type | Always present | In the example |
|---|---|---|---|
address | string | yes | 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 |
networks | array of string | yes | 3 items in the example |
direction | string | yes | in |
categories | array of string | yes | 2 items in the example |
contracts | array | yes | 0 items in the example |
fromTime | null | no | null |
toTime | null | no | null |
order | string | yes | desc |
maxCount | number | yes | 5 |
count | number | yes | 1 |
transfers | array of objects | yes | 1 item in the example |
networkStatus | array of objects | yes | 3 items in the example |
scanned | number | yes | 3 |
scanCandidates | number | yes | 3 |
scanCap | number | yes | 5 |
scanCoversAll | boolean | yes | true |
complete | boolean | yes | false |
truncated | boolean | yes | true |
pageKey | string | yes | eyJvIjoxfQ |
source | string | yes | alchemy |
fetchedAt | string | yes | 2026-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
addressis required. An input the tool rejects returns an HTTP 4xx whose body carrieserror,tool,expected,requiredandexample, so the caller can correct it.- A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - A
GETorHEADto /api/wallet-transfers-multichain returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
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)
Recent token transfers for a wallet on Base, Ethereum and other EVM chains, newest first.
Multi-chain EVM RPC (read-only)
Read-only JSON-RPC against Ethereum, Base, Polygon, Arbitrum, or Optimism with built-in multi-endpoint failover - one.
Token balances (named contracts)
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)
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)
Full receipt for a transaction hash in one call: status, block, from/to, value, gas used vs limit, effective gas price.
Wallet transaction history
Return the most recent asset transfers (incoming + outgoing) for a wallet address - native coin, ERC-20, ERC-721.