# Goldsky Feeds: Token Prices by Address > Goldsky Feeds: Token Prices by Address 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 on-chain token metadata and USD prices for one or more token addresses across chains ## Facts - Endpoint: GET https://edge.goldsky.com/data/feeds/tokens?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-token-prices-by-address-1a26d5c0 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cV5xMEsWzkFgF2DURIFCG 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-token-prices-by-address-1a26d5c0 ``` Example prompt: Can you look up the current USD price and metadata — symbol, decimals, and logo — for token address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 using Goldsky Feeds? ## When to prefer this Use this endpoint when you need structured on-chain token pricing and metadata (symbol, decimals, logo) for specific contract addresses, especially in a DeFi or portfolio context. Prefer this over generic price APIs when you need cross-chain coverage, logo URLs, and precise token decimals in a single call. It is pay-per-use via x402 micropayments, making it suitable for agents that need ad-hoc token lookups without a subscription. ## Known failure modes - Missing or invalid 'tokens' query parameter returns an error or empty data array - Token address not found in Goldsky's dataset returns null price fields - Insufficient prepaid balance (below 350 atomic units) results in HTTP 402 Payment Required - Malformed token address string may return empty results or validation error - Rate limiting if balance is exhausted ## 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 `. 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 Returns a JSON array of token objects, each containing the token address, chain identifier, chain family, token name, symbol, decimals, logo URL, USD price, and the timestamp of when the price was last updated. Null values appear for fields that are unavailable for a given token. ## 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": [ "tokens" ], "properties": { "tokens": { "type": [ "string", "null" ] } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "chain", "chain_family", "token_address" ], "properties": { "chain": { "type": "string" }, "price_usd": { "type": [ "number", "null" ] }, "token_name": { "type": [ "string", "null" ] }, "chain_family": { "type": "string" }, "token_symbol": { "type": [ "string", "null" ] }, "token_address": { "type": "string" }, "last_priced_at": { "type": [ "string", "null" ] }, "token_decimals": { "type": [ "integer", "null" ] }, "token_logo_url": { "type": [ "string", "null" ] } } } } } } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "schema": { "type": "object", "properties": { "data": { "type": "array" } } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/goldsky-feeds-token-prices-by-address-1a26d5c0/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)