# Solscan Account Token Holdings Lookup

> Solscan Account Token Holdings Lookup is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Retrieves all SPL token holdings, SOL balance, USD valuations, and recent transaction signatures for a given Solana wallet address via Solscan

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/solscan-account-tokens?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solscan-account-token-holdings-lookup-eb262273
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CazmrhFPr1WEjfrViBEt4

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 solscan-account-token-holdings-lookup-eb262273
```

Example prompt: Pull up all the token holdings and SOL balance for Solana wallet 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM — show me the top 20 by USD value and include the last 10 transaction signatures.

## When to prefer this

Use this endpoint when you need Solana-specific on-chain token holdings data sourced from Solscan, including verified token metadata, USD valuations, and recent signatures — all in a single call. Prefer this over raw RPC calls when you need human-readable token names, USD values, and portfolio aggregation without writing custom parsing logic. Best for agent workflows that need wallet analysis, portfolio monitoring, or counterparty due diligence on the Solana chain.

## Known failure modes

- Invalid or malformed Solana base58 address returns an error
- Wallet with no token accounts returns empty tokens array
- Solscan upstream API unavailable causes a 502/503 response
- Limit parameter out of range (>100 or <1) may return a validation error
- Network congestion on Solana mainnet may cause slow or partial responses

## How this service works

Solana account inventory: SOL balance, every SPL token account (Token and Token-2022 programs) with mint, amount, decimals and frozen state, token name, symbol, USD price and value for the largest holdings (Jupiter token data), and the latest transaction signatures with time and status. Read from Solana RPC.

## Output

Returns a JSON object containing: the queried wallet address, a list of SPL token accounts (each with mint address, token name, symbol, raw amount, decimals, USD price, USD value, program type, frozen status, and verification flag), the wallet's SOL balance, total known USD portfolio value, total and non-zero token account counts, recent transaction signatures (with slot, timestamp, memo, and success status), and a checkedAt timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Token accounts to return, 1 to 100 (default 20; non-zero balances, largest USD value first)"
      },
      "address": {
       "type": "string",
       "description": "Solana wallet address (base58, required)"
      },
      "signatures": {
       "type": "string",
       "description": "Latest signatures to return, 0 to 50 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "https://api.mainnet-beta.solana.com",
  "tokens": [
   {
    "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
    "name": "Pump",
    "amount": 24629953004.30587,
    "frozen": false,
    "symbol": "PUMP",
    "account": "A3NHkq47aEWwcGbkknGrF5ZbgU84riDRiJWd8Vu6RcT2",
    "program": "token-2022",
    "decimals": 6,
    "priceUsd": 0.004567979809194639,
    "valueUsd": 112509128.03,
    "verified": true
   },
   {
    "mint": "2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv",
    "name": "Pudgy Penguins",
    "amount": 4229183975.37087,
    "frozen": false,
    "symbol": "PENGU",
    "account": "6dErg7d5gCLo3APvWLxKNWJQaVoRsBJfEL7t3awCvccx",
    "program": "token",
    "decimals": 6,
    "priceUsd": 0.008026757394409917,
    "valueUsd": 33946633.75,
    "verified": true
   }
  ],
  "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "checkedAt": "2026-10-23T09:35:57.790Z",
  "signatures": [
   {
    "ok": true,
    "memo": null,
    "slot": 460311791,
    "time": "2026-10-23T04:45:31.000Z",
    "signature": "5e2PWQgUposSGSxZCeiW2nqpTTF6dKHm1fMTyVdQ74GEqrkDiqDfAzUnMW3SLY3Tz8RfqfbX2vhvG2qj3PwUDA56"
   },
   {
    "ok": true,
    "memo": null,
    "slot": 460236232,
    "time": "2026-10-23T00:18:50.000Z",
    "signature": "35xRmEsd5dTzV4EgQttP7qJ5ugDetwC4nSK7fgPoQd9sKaCj5MjyQM5ZtjhdU8aP8EucoKUBKftowzTdEPouQMf7"
   }
  ],
  "solBalance": 11175975.34445987,
  "knownValueUsd": 182738091.65,
  "tokenAccounts": 3157,
  "nonZeroTokenAccounts": 3114
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solscan-account-token-holdings-lookup-eb262273/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chainmarket-api.workers.dev](https://www.zero.xyz/host/api.chainmarket-api.workers.dev/llms.txt)