# Multi-Chain Wallet Portfolio & Transaction History

> Multi-Chain Wallet Portfolio & Transaction History is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns native and major-token balances plus recent transfer history for a wallet address on Ethereum, Base, and/or Solana

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-portfolio?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/multi-chain-wallet-portfolio-transaction-history-b1f88ecc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R5XOIUI9wzx6T7KM-ZSP0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability multi-chain-wallet-portfolio-transaction-history-b1f88ecc -d '<json body>'
```

Example prompt: Can you pull up the token balances and last 10 transfers for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on both Ethereum and Base?

## When to prefer this

Use this endpoint when you need multi-chain native and major-token balances and recent transfer history for a specific wallet on Ethereum, Base, or Solana. Prefer this over general blockchain explorers when you want a clean, spam-filtered JSON response ready for agent consumption. Do not use for USD valuations, NFT holdings, DeFi positions (liquidity, staking), long-tail or obscure token balances, or chains beyond Ethereum, Base, and Solana.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Requesting a chain incompatible with the address format (e.g. Solana chain for an 0x address) may return empty or error
- historyLimit out of range (>25 or <0) returns a validation error
- Network timeouts may occur given ~3000ms p95 latency
- Missing required 'address' field returns a schema validation error

## How this service works

Use when you need a multi-chain wallet balance, a wallet portfolio or wallet transaction history on Ethereum, Base or Solana. Do not use for uSD values, NFTs, DeFi positions, long-tail tokens or chains beyond Ethereum, Base and Solana. Returns JSON with a multi-chain wallet balance and transaction history: native and major-token balances on Ethereum, Base or Solana plus the latest transfers, without airdrop spam for 0.005 USDC per call. Typical response time 3000 ms (p95). Category: Data.

## Output

A JSON object keyed by chain (ethereum, base, solana) each containing: native token symbol and balance, an array of major token balances (symbol, contract, decimals, balance), and a history array of recent transfers (hash, timestamp, direction in/out, counterparty address, asset, amount). Also includes the queried address and an updatedAt timestamp. Airdrop spam is filtered out.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chains": {
       "type": "array",
       "items": {
        "enum": [
         "ethereum",
         "base",
         "solana"
        ],
        "type": "string"
       },
       "maxItems": 3,
       "minItems": 1,
       "description": "Chains to read (ethereum and base for a 0x address, solana for a Solana address, when omitted), e.g. [\"base\"]"
      },
      "address": {
       "type": "string",
       "maxLength": 44,
       "minLength": 32,
       "description": "Wallet address: 0x... for Ethereum and Base, or a Solana address, e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
      },
      "historyLimit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 0,
       "description": "Latest transfers to return per chain, 0 to 25 (10 when omitted), e.g. 5"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "ethereum",
      "base",
      "solana",
      "updatedAt",
      "note"
     ],
     "properties": {
      "base": {
       "anyOf": [
        {
         "type": "object",
         "required": [
          "native",
          "tokens",
          "history"
         ],
         "properties": {
          "native": {
           "type": "object",
           "required": [
            "symbol",
            "balance"
           ],
           "properties": {
            "symbol": {
             "type": "string"
            },
            "balance": {
             "type": "string"
            }
           },
           "additionalProperties": false
          },
          "tokens": {
           "type": "array",
           "items": {
            "type": "object",
            "required": [
             "sym
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": {
   "native": {
    "symbol": "ETH",
    "balance": "0"
   },
   "tokens": [
    {
     "symbol": "USDC",
     "balance": "0.015",
     "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     "decimals": 6
    }
   ],
   "history": [
    {
     "hash": "0xeca4b84c7be1b01b92314dd139ba623f4065ea2d9af702cdca1a6e006fc92f09",
     "time": "2026-10-17T23:55:53.000Z",
     "asset": "USDC",
     "amount": "0.005",
     "direction": "in",
     "counterparty": "0x87db3c25d1e8e40f8ef240d48a711b0c355cf8cf"
    },
    {
     "hash": "0x618c2559d32eef4fa33af283a53db6e96dacd049c22a586a8dc4bc3a603326e4",
     "time": "2026-10-17T23:54:41.000Z",
     "asset": "USDC",
     "amount": "0.005",
     "direction": "in",
     "counterparty": "0x87db3c25d1e8e40f8ef240d48a711b0c355cf8cf"
    }
   ]
  },
  "note": "Balances of the native coin and major tokens of each chain (a fixed list; airdrop spam and long-tail tokens are left out). History: the latest native and major-token transfers in and out; on Solana, the net change per transaction. Amounts are decimal strings in token units, without USD values.",
  "solana": null,
  "address": "0xFf918CFB0690FdEd4224DBDab916F6E6F78882b7",
  "ethereum": null,
  "updatedAt": "2026-10-18T02:46:08.863Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/multi-chain-wallet-portfolio-transaction-history-b1f88ecc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)