# Arkham Portfolio Time-Series by Entity

> Arkham Portfolio Time-Series by Entity 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 historical portfolio value and token balances over time for a named blockchain entity, broken down by chain and asset.

## Facts

- Endpoint: POST https://api.arkm.com/x402/portfolio/time-series/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-portfolio-time-series-by-entity-b6a02973
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mKoxxayC3ztNiRl0kl2-q

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-portfolio-time-series-by-entity-b6a02973 -d '<json body>'
```

Example prompt: Pull the Arkham portfolio time series for the entity 'Binance' from January 1 2023 to July 19 2023, broken down by chain and token.

## When to prefer this

Use this endpoint when you need historical, time-stamped portfolio data for a known, labeled blockchain entity (e.g. exchange, fund, protocol DAO) rather than a raw address. It is ideal for trend analysis, charting portfolio evolution, or comparing cross-chain holdings at specific points in time. Prefer Arkham over generic on-chain RPC queries when you need human-readable entity labels and aggregated multi-wallet, multi-chain portfolio views.

## Known failure modes

- Unknown or unresolved entity name returns empty result or 404
- Date range outside available data returns empty time-series
- Insufficient USDC balance for x402 payment causes request to fail with 402
- Malformed entity identifier causes 400 bad request
- Rate limiting or throttling if too many requests are issued rapidly

## How this service works

Get Arkham daily portfolio time series for an entity token. $0.60 per call.

## Output

A JSON object keyed by ISO 8601 timestamps, where each entry contains a nested breakdown by blockchain network and then by asset. Each asset entry includes the asset ID, name, ticker symbol, current price in USD, balance held, and total USD value. Covers all chains the entity has activity on.

## 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,arbitrum_one'). If omitted, returns data across…"
  },
  "entity": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The entity ID to query time series data for. Accepts an Arkham entity ID or a user entity ID."
  },
  "pricingId": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The CoinGecko pricing ID of the token to track."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "2023-07-19T00:00:00Z": {
   "ethereum": {
    "ethereum": {
     "id": "ethereum",
     "usd": 7541947049.244255,
     "name": "Ethereum",
     "price": 1897.72,
     "symbol": "eth",
     "balance": 3974214.873239601
    }
   },
   "arbitrum_one": {
    "ethereum": {
     "id": "ethereum",
     "usd": 211904206.9619752,
     "name": "Ethereum",
     "price": 1897.72,
     "symbol": "eth",
     "balance": 111662.5250099989
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-portfolio-time-series-by-entity-b6a02973/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)