# Arkham x402 Entity Portfolio

> Arkham x402 Entity Portfolio 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-14).

Returns the full token portfolio (balances, USD values, prices) for a named blockchain entity across all tracked chains.

## Facts

- Endpoint: POST https://api.arkm.com/x402/portfolio/entity
- Price: $0.4/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-portfolio-dc3c16aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2pKvpLzNIWjJNSLfiSR3N

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-portfolio-dc3c16aa -d '<json body>'
```

Example prompt: Pull the full token portfolio for the Arkham entity 'jump-trading' — I want to see all their holdings across every chain with current USD values and balances.

## When to prefer this

Use this endpoint when you need a comprehensive, cross-chain token portfolio for a known Arkham-labeled entity (exchange, fund, protocol, whale) rather than a raw wallet address. Prefer this over raw on-chain lookups when you want entity-level aggregation with USD valuations and token metadata already resolved. Best suited for DeFi research, competitive intelligence, and on-chain fund analysis where Arkham's entity labeling adds context beyond a plain address query.

## Known failure modes

- Unknown or misspelled entity name returns empty or 404 response
- Insufficient USDC balance causes x402 payment failure before data is returned
- Entity with no tracked holdings returns empty portfolio object
- Rate limiting or API key issues result in 401/429 errors
- Stale price data may cause USD values to lag real-time market prices

## How this service works

Get Arkham portfolio history for an entity. $0.40 per call.

## Output

A nested JSON object keyed by blockchain name, then by token ID, containing each token's name, symbol, balance (raw units), current price (USD), and total USD value held by the entity. Multiple chains (e.g. Ethereum, BSC) are returned in a single response.

## 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…"
  },
  "entity": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The entity ID to query portfolio history for. Accepts an Arkham entity ID or a user entity ID."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bsc": {
   "2049": {
    "id": "2049",
    "usd": 1605.8928,
    "name": "2049",
    "price": 0.01338244,
    "symbol": "2049",
    "balance": 120000
   },
   "aave": {
    "id": "aave",
    "usd": 34023851.49966592,
    "name": "Aave",
    "price": 109.13,
    "symbol": "aave",
    "balance": 311773.5865450922
   }
  },
  "ethereum": {
   "0x": {
    "id": "0x",
    "usd": 26797375.46937224,
    "name": "0x Protocol",
    "price": 0.369874,
    "symbol": "zrx",
    "balance": 72450011.27241233
   },
   "1inch": {
    "id": "1inch",
    "usd": 61415514.90892401,
    "name": "1INCH",
    "price": 0.45496,
    "symbol": "1inch",
    "balance": 134991020.9884913
   }
  }
 }
}
```

## More

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