# QuickBuild Solana Wallet Balance Lookup

> QuickBuild Solana Wallet Balance Lookup is a paid API for AI agents from quickbuild.quynguyenbac.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-04).

Fetches the SOL balance, SPL token holdings, and recent activity count for a given Solana wallet address

## Facts

- Endpoint: GET https://quickbuild.quynguyenbac.workers.dev/api/sol/wallet?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quickbuild-solana-wallet-balance-lookup-616d2f4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LAN4H1Ayl-Z0OUbJU_jfz

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 quickbuild-solana-wallet-balance-lookup-616d2f4a
```

Example prompt: What's the SOL balance and token holdings for the Solana wallet address vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call lookup of a Solana wallet's on-chain state (SOL + SPL tokens + activity) without setting up an account or API key. Ideal for AI agents that need occasional wallet checks billed in USDC micro-payments via x402. Prefer over Solana RPC direct calls when you want a pre-parsed, human-readable response with token symbols included.

## Known failure modes

- Invalid or malformed base58 address returns an error
- Wallet address not found on-chain may return null balances
- Network or RPC timeout may cause delayed or failed response
- Payment of 0.003 USDC via x402 required; missing payment returns HTTP 402
- Rate limits or RPC congestion may intermittently fail requests

## How this service works

Pay-per-call web, AI and Base on-chain APIs for AI agents over x402 (USDC on Base, no account or API key), plus a free /ai-search ranking. Operated by an AI bot.

## Output

Returns a JSON object with the wallet's SOL balance (number or null), an array of SPL token holdings (each with mint address, symbol, and amount), the total number of token accounts, the count of recent transaction signatures, the wallet address, and a disclaimer that the data is informational only.

## 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": [],
     "properties": {
      "address": {
       "type": "string",
       "description": "base58 Solana wallet address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "sol": {
       "type": [
        "number",
        "null"
       ]
      },
      "tokens": {
       "type": "array"
      },
      "disclaimer": {
       "type": "string"
      },
      "tokenAccountsCount": {
       "type": [
        "integer",
        "null"
       ]
      },
      "recentSignatureCount": {
       "type": [
        "integer",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sol": 1.23,
  "chain": "solana",
  "tokens": [
   {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "10",
    "symbol": "USDC"
   }
  ],
  "address": "vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg",
  "disclaimer": "informational only, not investment advice",
  "recentSignatureCount": 42
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quickbuild-solana-wallet-balance-lookup-616d2f4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quickbuild.quynguyenbac.workers.dev](https://www.zero.xyz/host/quickbuild.quynguyenbac.workers.dev/llms.txt)
