# Arkham x402 – Wallet Flow Data (Address)

> Arkham x402 – Wallet Flow Data (Address) is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-15).

Returns time-series inflow and outflow data for a blockchain address across multiple chains, with cumulative totals, via pay-per-request pricing.

## Facts

- Endpoint: POST https://api.arkm.com/x402/flow/address
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-wallet-flow-data-address-7911f3cb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_98kCnacZjGiTWSCXUqYDG

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-wallet-flow-data-address-7911f3cb -d '<json body>'
```

Example prompt: Can you pull the full inflow and outflow history for Ethereum address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 across all chains using Arkham's wallet intelligence API?

## When to prefer this

Use this endpoint when you need structured, time-series capital flow data (inflows, outflows, cumulative totals) for a specific blockchain address across multiple chains. It is ideal for tracking whale wallets, exchange hot wallets, protocol treasuries, or any labeled entity in Arkham's intelligence graph. Prefer this over generic block explorers when you need pre-aggregated USD-denominated flow metrics rather than raw transaction lists.

## Known failure modes

- Invalid or malformed blockchain address returns an error response
- Unsupported chain identifier results in empty or error response
- Insufficient USDC balance for x402 payment causes payment failure and no data returned
- Address with no on-chain history returns empty arrays per chain
- Rate limiting or API key issues cause 401/429 responses

## How this service works

Get Arkham historical USD flows for an address. $0.40 per call.

## Output

A JSON object keyed by chain name (e.g. 'ethereum', 'bsc'), each containing an array of time-series records. Each record includes a UTC timestamp, the inflow and outflow amounts for that period, and running cumulative inflow and outflow totals in USD.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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 flow data for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bsc": [
   {
    "time": "2023-10-31T00:00:00Z",
    "inflow": 99.71,
    "outflow": 0,
    "cumulativeInflow": 91579540.89000005,
    "cumulativeOutflow": 92789860.85
   },
   {
    "time": "2023-12-08T00:00:00Z",
    "inflow": 2493652.26,
    "outflow": 0,
    "cumulativeInflow": 91579640.60000002,
    "cumulativeOutflow": 92789860.85
   }
  ],
  "ethereum": [
   {
    "time": "2023-12-03T00:00:00Z",
    "inflow": 523882897.43,
    "outflow": 554928524.09,
    "cumulativeInflow": 1027355003822.289,
    "cumulativeOutflow": 1023262378331.282
   },
   {
    "time": "2023-12-04T00:00:00Z",
    "inflow": 1312623236.01,
    "outflow": 1204741283.07,
    "cumulativeInflow": 1027878886719.719,
    "cumulativeOutflow": 1023817306855.372
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-wallet-flow-data-address-7911f3cb/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)