# Goldsky Feeds: Wallet Token Balances

> Goldsky Feeds: Wallet Token Balances is a paid API for AI agents from edge.goldsky.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-31).

Returns token balances across chains for a given wallet address, with optional USD pricing, metadata, and pagination

## Facts

- Endpoint: GET https://edge.goldsky.com/data/feeds/wallets/balances?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/goldsky-feeds-wallet-token-balances-ff246023
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9FCq2tOknq8rg6SnKBaO8

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 goldsky-feeds-wallet-token-balances-ff246023
```

Example prompt: What tokens does wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold across all chains, including their USD values and token logos?

## When to prefer this

Use this endpoint when you need structured, multi-chain token balance data for a specific wallet address, especially when USD valuation, token metadata (logos, decimals, symbols), or Solana-specific fields (lamports, rent) are needed. Prefer it over generic RPC calls when you want normalized cross-chain data with pricing in a single REST call rather than making separate chain-specific balance queries.

## Known failure modes

- Missing required 'address' query parameter returns a 400 validation error
- Invalid or malformed wallet address returns empty data or an error
- Unsupported chain identifier causes a 400 or empty result
- Expired or insufficient prepaid balance (x402 payment required) returns a 402 Payment Required
- Rate limiting or upstream indexer lag may cause stale or incomplete balance data
- Very large wallets with many tokens may require multiple paginated requests

## How this service works

Goldsky Feeds: onchain data over REST. Formerly Edge Data / Data APIs; existing URLs and keys keep working.

- **Wallet feeds**: one wallet's token transfers or balances across chains, with USD values (`/feeds/wallets/transfers`, `/feeds/wallets/balances`).
- **Tokens**: metadata and current USD price for up to 100 `chain:token_address` pairs per request (`/feeds/tokens`).
- **Prediction markets** (Polymarket, on Polygon): Activity, Positions and Balances (`/polymarket/*`).
- **Chain datasets**: Blocks and Chain head for each supported chain (`/blocks/{chain}`, `/blocks/{chain}/head`).

Base URL: `https://edge.goldsky.com/data`. Every endpoint is a `GET` that returns JSON.

## Authentication

Send your Feeds API key in the `x-api-key` header, as the `?key=` query parameter, or as `Authorization: Bearer <key>`. Get it at [app.goldsky.com](https://app.goldsky.com) under **Feeds → API keys**. One key works for every endpoint; an invalid key gets `401`.

## Billing

Requests made with a key bill compute units (CUs) at $10 per million:

- Wallet feeds and Tokens: 35 CUs per request.
- Prediction markets and Chain datasets: 1 CU per row returned. Chain head is 1 CU per call.

Errors are not billed, and a Prediction markets or Chain datasets request that returns no rows costs nothing. Rate limits are set per plan (`429` when exceeded); Goldsky support can raise them.

## Pay per request with x402

No account or key needed. A request without a key gets `402` with an x402 v2 challenge in the `PAYMENT-REQUIRED` header (base64 JSON; the body carries the same challenge). Pay in USDC through Circle Gateway and retry. Each payment is a $0.005 prepaid top-up, tied to the paying wallet and shared with Edge RPC, that later requests spend down:

- Wallet feeds and Tokens: $0.00035 (350 atomic USDC) per request.
- Prediction markets and Chain datasets: $0.00001 (10 atomic USDC) per request, whatever the row count.

The payment flow is in [x402 nanopayments](https://docs.goldsky.com/edge-rpc/capabilities/x402).

## Output

A JSON object containing the queried wallet address, a total_value_usd field summing all holdings, a paginated data array of token balance records (each with chain, chain_family, token_address, balance_raw, token_symbol, token_name, token_decimals, price_usd, value_usd, token_logo_url, block_number, block_timestamp, and optional Solana-specific fields), and a pagination object with page_size and next_page_token for cursor-based traversal.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chains": {
       "type": [
        "string",
        "null"
       ]
      },
      "address": {
       "type": [
        "string",
        "null"
       ]
      },
      "page_size": {
       "type": [
        "integer",
        "null"
       ]
      },
      "page_token": {
       "type": [
        "string",
        "null"
       ]
      },
      "include_rent": {
       "type": "boolean"
      },
      "token_symbol": {
       "type": [
        "string",
        "null"
       ]
      },
      "min_value_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "token_address": {
       "type": [
        "string",
        "null"
       ]
      },
      "include_prices": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "include_lamports": {
       "type": "boolean"
      },
      "include_historical": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "include_chain_fields": {
       "type": "boolean"
      },
      "include_unknown_price": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "include_token_metadata": {
       "type": [
        "boolean",
        "null"
       ]
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "total_value_usd",
      "wallets",
      "data",
      "pagination"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "address",
         "chain",
         "chain_family",
         "token_address",
         "balance_raw",
         "block_number",
         "block_timestamp"
        ],
        "properties": {
         "chain": {
          "type": "string"
         },
         "solana": {
          "oneOf": [
           {
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "data": {
    "type": "array"
   },
   "address": {
    "type": "string"
   },
   "pagination": {
    "type": "object"
   },
   "total_value_usd": {
    "type": "number"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/goldsky-feeds-wallet-token-balances-ff246023/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from edge.goldsky.com](https://www.zero.xyz/host/edge.goldsky.com/llms.txt)