# ChainScope Token Holdings

> ChainScope Token Holdings is a paid API for AI agents from chainsscope.duckdns.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieves token holdings and balances for a wallet address on Ethereum, Base, Bitcoin, or Solana, with USD valuations per token.

## Facts

- Endpoint: POST https://chainsscope.duckdns.org/tools/token-holdings
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainscope-token-holdings-183ce4ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fAuWaTPElzWBMgay4GNt3

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 chainscope-token-holdings-183ce4ec -d '<json body>'
```

Example prompt: What tokens does the Solana wallet yEx9WBP1NnzoTpDmi67F536bso3YNcQPBRhWRoswTBS hold right now, and what is the total USD value of its holdings?

## When to prefer this

Choose this endpoint when you need a unified, multi-chain token holdings lookup without building separate integrations for each blockchain. It is ideal for agents that need to inspect wallet portfolios across Ethereum, Base, Bitcoin, and Solana through a single consistent interface, and when per-call micropayment billing via x402 is acceptable.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain identifier causes rejection
- Address with no token holdings returns an empty holdings array
- Network timeout or upstream RPC failure causes a 5xx error
- Payment not attached or insufficient USDC triggers 402 payment required

## How this service works

Token balances for a wallet, with USD value where a price is available: full SPL token enumeration on Solana, or specific ERC20 balances on Ethereum/Base (a verified default watchlist, or your own token contract list) -- not available for Bitcoin, which has no token standard.

## Output

Returns a JSON object containing the chain, the queried address, an array of token holdings (each with symbol, balance, USD value, raw balance, and token contract address), and the total portfolio value in USD across all held tokens.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "solana",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string"
  },
  "address": {
   "type": "string"
  },
  "token_addresses": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "solana",
  "address": "yEx9WBP1NnzoTpDmi67F536bso3YNcQPBRhWRoswTBS",
  "holdings": [
   {
    "symbol": null,
    "balance": "12.5",
    "value_usd": 12.5,
    "raw_balance": "12500000",
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
   }
  ],
  "total_value_usd": 12.5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainscope-token-holdings-183ce4ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainsscope.duckdns.org](https://www.zero.xyz/host/chainsscope.duckdns.org/llms.txt)