# Arkham x402 – Solana Entity Subaccount Balances

> Arkham x402 – Solana Entity Subaccount Balances 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 all Solana token balances for the subaccounts belonging to a named entity (e.g. a labeled exchange, fund, or protocol) tracked by Arkham Intelligence.

## Facts

- Endpoint: POST https://api.arkm.com/x402/balances/solana/subaccounts/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-solana-entity-subaccount-balances-24141af2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NuvwQh14nCznCgYr3L1sJ

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-solana-entity-subaccount-balances-24141af2 -d '<json body>'
```

Example prompt: Pull the Solana subaccount balances for the Tensor entity on Arkham so I can see all their token holdings and USD values across every tracked wallet.

## When to prefer this

Use this endpoint when you need a consolidated, labeled view of all Solana token balances for a named entity (exchange, fund, protocol, or whale) as tracked and labeled by Arkham Intelligence — particularly when you want subaccount-level granularity with USD valuations rather than raw on-chain data from an RPC node. Prefer over raw Solana RPC calls when Arkham's entity labeling and aggregation across dozens of subaccounts is essential.

## Known failure modes

- Unknown or unrecognized entity name returns empty array or 404
- Entity exists but has no Solana subaccounts tracked, returning empty list
- Invalid request body or missing entity field returns 400 Bad Request
- Insufficient x402 payment or expired payment token returns 402 Payment Required
- Rate limiting or quota exceeded returns 429 Too Many Requests
- Arkham data lag means very recent wallet changes may not be reflected

## How this service works

Get Solana subaccount balances for entities. $0.60 per call.

## Output

An array of token holding objects, each containing: entity/subaccount ID, token name, symbol, contract address, raw and exact balance figures, current token price in USD, USD value of that holding, and the owning wallet address on Solana.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Maximum number of subaccount balance entries to return. Default: 1000."
  },
  "entities": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Comma-separated list of entity IDs to query subaccount balances for."
  },
  "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 query subaccount balances for. Filters results to balances of this token."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "id": "tensor",
   "usd": 2952880.264224012,
   "name": "Tensor",
   "price": 0.04028654,
   "symbol": "TNSR",
   "address": "GugV3a7dGm2n5SDmsoiWKgaPGjwkoMBuz1wQaDCAftKb",
   "balance": 73296943.94763146,
   "balanceExact": "73296943947631461",
   "ownerAddress": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9"
  }
 ]
}
```

## More

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