# Arkham x402 Portfolio by Address

> Arkham x402 Portfolio by Address is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-14).

Returns a breakdown of token holdings and USD values for a given blockchain wallet address across multiple chains

## Facts

- Endpoint: POST https://api.arkm.com/x402/portfolio/address
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-portfolio-by-address-f4c53320
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MEMWf4W13kWnNfmWRRtZE

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 arkham-x402-portfolio-by-address-f4c53320 -d '<json body>'
```

Example prompt: Pull up the full token portfolio for wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE — I want to see all their holdings broken down by chain and token with current USD values.

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-chain token portfolio breakdown for a specific wallet address with real USD valuations, especially when Arkham's proprietary wallet intelligence and entity labeling is relevant. Prefer this over generic block explorers when you need structured, machine-readable data ready for analysis rather than human-readable pages.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Address with no holdings may return empty chain objects
- Unsupported chain returns no data for that chain
- Rate limiting or insufficient USDC payment triggers 402 response
- Network timeout on slow RPC lookups

## How this service works

Get Arkham portfolio history for an address. $0.20 per call.

## Output

A nested JSON object keyed first by blockchain (e.g. 'ethereum', 'bsc') and then by token identifier, containing each token's name, symbol, price in USD, balance quantity, and total USD value of that holding.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "time": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Unix timestamp in milliseconds for the historical snapshot. The time is truncated to the start of the UTC day."
  },
  "chains": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Chains to filter by, as a single comma-separated value (e.g. 'ethereum,bsc'). If omitted, returns data across all suppo…"
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The blockchain address to query portfolio history for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bsc": {
   "1inch": {
    "id": "1inch",
    "usd": 506.1975952,
    "name": "1INCH",
    "price": 0.45496,
    "symbol": "1inch",
    "balance": 1112.62
   },
   "alchemy-pay": {
    "id": "alchemy-pay",
    "usd": 0.2132812,
    "name": "Alchemy Pay",
    "price": 0.02132812,
    "symbol": "ach",
    "balance": 10
   }
  },
  "ethereum": {
   "0x": {
    "id": "0x",
    "usd": 3710766.766003987,
    "name": "0x Protocol",
    "price": 0.369874,
    "symbol": "zrx",
    "balance": 10032515.8459475
   },
   "1inch": {
    "id": "1inch",
    "usd": 2759727.17734319,
    "name": "1INCH",
    "price": 0.45496,
    "symbol": "1inch",
    "balance": 6065867.718795477
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-portfolio-by-address-f4c53320/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)