# Ambolt Solana Wallet Balances

> Ambolt Solana Wallet Balances is a paid API for AI agents from api.ambolt.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Fetches SOL and SPL token balances with USD valuations for a given Solana wallet address

## Facts

- Endpoint: GET https://api.ambolt.dev/v1/solana-wallet-balances?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ambolt-solana-wallet-balances-4ce3870b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_chqvpZB-8JZg6fQP6RqOx

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 ambolt-solana-wallet-balances-4ce3870b
```

Example prompt: What are the current SOL and token balances for Solana wallet 4PWuXBz8DDzwpFkjU7BfamCKtfAtGyBD8ShgUgcCFiPr, and what's the total USD value? Show me up to 20 holdings.

## When to prefer this

Use this endpoint when you need a quick, pay-per-call SOL and SPL token balance lookup with USD valuations for any Solana mainnet wallet, without managing your own RPC infrastructure or price aggregation. Prefer it over self-hosted solutions when cost predictability ($0.01 per call) matters more than high query volume. It is especially useful for AI agents that need on-chain portfolio snapshots as part of larger workflows.

## Known failure modes

- Invalid or malformed Solana address (fails regex pattern) returns a 400 error
- Wallet address not found on Solana mainnet returns empty balances or 404
- RPC node unavailability causes a 503 or timeout
- Token price data unavailable for illiquid or unverified tokens — valueUsd may be zero or missing
- Limit parameter out of range (< 1 or > 50) returns a 400 validation error
- Payment not made returns 402 Payment Required (x402 protocol)

## How this service works

Pay-per-call data tools for developers and AI agents: company registers, documents, tenders, rates and on-chain facts as MCP tools, x402 endpoints and Apify Actors.

## Output

A JSON object containing the wallet's native SOL balance in both lamports and SOL units with a live USD price and value, an array of SPL token holdings (each with mint address, name, symbol, amount, decimals, USD price, USD value, and verified status) sorted by USD value descending, the total portfolio value in USD, a price coverage flag (full/partial), a data source disclaimer, and the timestamp the data was fetched.

## 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": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1,
       "description": "Number of holdings to return, most valuable first."
      },
      "address": {
       "type": "string",
       "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
       "description": "Solana wallet address."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sol": {
   "sol": 0.02458096,
   "lamports": 24580960,
   "usdPrice": 118.0047940645822,
   "valueUsd": 2.9
  },
  "source": "Source: Solana mainnet RPC (balances) and aggregated market prices. Values are estimates and illiquid tokens can be mispriced. Not advice.",
  "tokens": [
   {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "name": "USD Coin",
    "amount": 1,
    "symbol": "USDC",
    "decimals": 6,
    "usdPrice": 0.9999950360940942,
    "valueUsd": 1,
    "verified": true
   }
  ],
  "address": "4PWuXBz8DDzwpFkjU7BfamCKtfAtGyBD8ShgUgcCFiPr",
  "checkedAt": "2026-10-02T21:36:01.746Z",
  "tokenCount": 1,
  "totalValueUsd": 3.9,
  "pricesCoverage": "full"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ambolt-solana-wallet-balances-4ce3870b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ambolt.dev](https://www.zero.xyz/host/api.ambolt.dev/llms.txt)