# Solana Account Balance & State Lookup

> Solana Account Balance & State Lookup is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-12).

Returns the native SOL balance (in lamports and SOL), account existence, owning program, executable flag, and data size for any Solana address read directly from the public ledger.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/solana/balance/{address}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-solana-account-balance-state-lookup-48128d6c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_USxcsADXT4cr6GFea_gqc

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 agents-x402stock-xyz-solana-account-balance-state-lookup-48128d6c
```

Example prompt: What's the current SOL balance and account state for the Solana address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU? Tell me the lamports, SOL, whether it exists, and who owns the account.

## When to prefer this

Choose this endpoint when you need raw on-chain Solana account state — balance in lamports/SOL, account existence, owning program, or executable flag — directly from the public ledger without needing a Jupiter API key or any account setup. Prefer it over DEX-aggregator APIs when you just need native SOL balance or program ownership data rather than token swap quotes or token metadata. Pay-per-call pricing via USDC/x402 makes it ideal for agents that query infrequently or on-demand without subscription overhead.

## Known failure modes

- Invalid base58 address format returns an error response
- Account that has never received SOL returns exists: false with zero lamports
- Network or RPC timeout may cause delayed or failed responses
- Malformed path parameter (non-base58 characters) may return a 400 error
- Extremely new accounts may not yet be reflected if there is slight ledger read latency

## How this service works

The native SOL balance and basic account state for any Solana address, read from the public ledger: lamports and SOL, whether the account exists, its owning program, executable flag, and data size. Pass a base58 address in the path. Keyless on-chain data — no Jupiter API, no account. From x402stock, a pay-per-call market & economic data API. Pay per request in USDC via x402, no API key.

## Output

A JSON object containing the queried Solana address, its balance in both lamports and SOL, a boolean indicating whether the account exists on the ledger, the owning program address (or null), whether the account is executable, the account data size in bytes, plus metadata fields for source, venue (solana), and timestamp (as_of).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "address": {
   "type": "string",
   "description": "Solana account address (base58)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "address",
    "lamports",
    "sol",
    "exists",
    "owner",
    "executable",
    "data_size"
   ],
   "properties": {
    "sol": {
     "type": "number"
    },
    "owner": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ],
     "description": "Owning program of the account, if it exists."
    },
    "exists": {
     "type": "boolean",
     "description": "False for an address the ledger has never seen."
    },
    "address": {
     "type": "string"
    },
    "lamports": {
     "type": "number"
    },
    "data_size": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ],
     "description": "Account data size in bytes."
    },
    "executable": {
     "anyOf": [
      {
       "type": "boolean"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type": "string"
  },
  "venue": {
   "type": "string",
   "const": "solana"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-solana-account-balance-state-lookup-48128d6c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)