# Coinlight SOL Balance Lookup

> Coinlight SOL Balance Lookup is a paid API for AI agents from coinlight-app.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Returns the native SOL balance of any Solana wallet address in both SOL and lamports, read live from mainnet.

## Facts

- Endpoint: GET https://coinlight-app.vercel.app/p/solana-sol-balance?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinlight-sol-balance-lookup-b1121df8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8VthbstwlOL32rNUypJH_

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 coinlight-sol-balance-lookup-b1121df8
```

Example prompt: What's the current SOL balance of the Solana wallet HD1ryR3dYSXBVNGfJZydbpmnChiE1wrAQkupWWtHt4pM? Give me both the SOL amount and the raw lamport value.

## When to prefer this

Use this endpoint when you need a fast, live, single-call SOL balance lookup for any Solana address without needing token holdings or portfolio data. Prefer it over the full portfolio endpoint when you only need native SOL and want to minimize cost and latency.

## Known failure modes

- Invalid or malformed base58 address returns an error response
- Address not found on mainnet returns zero balance or error
- Network latency or Solana RPC downtime may cause timeouts
- Missing 'address' query parameter returns a validation error
- Payment failure (insufficient USDC) blocks the request

## How this service works

Coinlight charges USDC per API call with the x402 protocol on Solana and Base.

## Output

A JSON response containing the Solana wallet address queried, its balance expressed in SOL (human-readable decimal), and its balance in lamports (raw integer), fetched live from Solana mainnet.

## 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",
     "examples": [
      {
       "address": "HD1ryR3dYSXBVNGfJZydbpmnChiE1wrAQkupWWtHt4pM"
      }
     ],
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Solana address (base58)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "endpoint": "Solana SOL balance"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinlight-sol-balance-lookup-b1121df8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coinlight-app.vercel.app](https://www.zero.xyz/host/coinlight-app.vercel.app/llms.txt)