# Arkham x402 Entity Flow Data

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

Returns time-series inflow and outflow fund flow data for a named blockchain entity across Bitcoin, Ethereum, and other chains.

## Facts

- Endpoint: POST https://api.arkm.com/x402/flow/entity
- Price: $0.6/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-entity-flow-data-345fc52f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pfgzIBXssF94r8oD33H0o

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-entity-flow-data-345fc52f -d '<json body>'
```

Example prompt: Pull the daily inflow and outflow data for Binance on both Bitcoin and Ethereum from Arkham for the last 30 days so I can see how capital has been moving.

## When to prefer this

Use this endpoint when you need time-series fund flow data (inflow/outflow) for a specific named on-chain entity (exchange, fund, protocol) across multiple chains. Prefer it over generic blockchain explorers when you need entity-level aggregation with Arkham's labeling, or when you need cumulative flow metrics rather than raw transaction data.

## Known failure modes

- Unknown entity name returns empty arrays or 404
- Invalid time range returns error or empty data
- Payment failure (insufficient USDC) returns 402 with payment requirements
- Unsupported chain returns missing key in response
- Rate limiting if too many pay-per-request calls in quick succession

## How this service works

Get Arkham historical USD flows for an entity. $0.60 per call.

## Output

A JSON object keyed by blockchain (e.g. 'bitcoin', 'ethereum'), each containing an array of daily data points with fields: time (ISO timestamp), inflow (USD), outflow (USD), cumulativeInflow (USD), and cumulativeOutflow (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,bitcoin'). If omitted, returns data across all s…"
  },
  "entity": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The entity ID to query flow data for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bitcoin": [
   {
    "time": "2022-01-21T00:00:00Z",
    "inflow": 6565472523.45,
    "outflow": 6632247150.18,
    "cumulativeInflow": 905891016225.6692,
    "cumulativeOutflow": 889779478783.3397
   },
   {
    "time": "2022-01-22T00:00:00Z",
    "inflow": 528887137.66,
    "outflow": 660515462.75,
    "cumulativeInflow": 912456488749.1191,
    "cumulativeOutflow": 896411725933.5198
   }
  ],
  "ethereum": [
   {
    "time": "2022-01-08T00:00:00Z",
    "inflow": 1588990961.6,
    "outflow": 1499520350.86,
    "cumulativeInflow": 1425833420702.87,
    "cumulativeOutflow": 1396841791568.538
   },
   {
    "time": "2022-01-09T00:00:00Z",
    "inflow": 1370833866.45,
    "outflow": 1438004592.65,
    "cumulativeInflow": 1427422411664.47,
    "cumulativeOutflow": 1398341311919.398
   }
  ]
 }
}
```

## More

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