{"uid":"cap_cV5xMEsWzkFgF2DURIFCG","slug":"goldsky-feeds-token-prices-by-address-1a26d5c0","name":"Goldsky Feeds: Token Prices by Address","description":"Goldsky Feeds: onchain data over REST. Formerly Edge Data / Data APIs; existing URLs and keys keep working.\n\n- **Wallet feeds**: one wallet's token transfers or balances across chains, with USD values (`/feeds/wallets/transfers`, `/feeds/wallets/balances`).\n- **Tokens**: metadata and current USD price for up to 100 `chain:token_address` pairs per request (`/feeds/tokens`).\n- **Prediction markets** (Polymarket, on Polygon): Activity, Positions and Balances (`/polymarket/*`).\n- **Chain datasets**: Blocks and Chain head for each supported chain (`/blocks/{chain}`, `/blocks/{chain}/head`).\n\nBase URL: `https://edge.goldsky.com/data`. Every endpoint is a `GET` that returns JSON.\n\n## Authentication\n\nSend 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`.\n\n## Billing\n\nRequests made with a key bill compute units (CUs) at $10 per million:\n\n- Wallet feeds and Tokens: 35 CUs per request.\n- Prediction markets and Chain datasets: 1 CU per row returned. Chain head is 1 CU per call.\n\nErrors 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.\n\n## Pay per request with x402\n\nNo 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:\n\n- Wallet feeds and Tokens: $0.00035 (350 atomic USDC) per request.\n- Prediction markets and Chain datasets: $0.00001 (10 atomic USDC) per request, whatever the row count.\n\nThe payment flow is in [x402 nanopayments](https://docs.goldsky.com/edge-rpc/capabilities/x402).","url":"https://edge.goldsky.com/data/feeds/tokens?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"]}}}}}}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"data":{"type":"array"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pRX4vkqZzdsS_wojPihAN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain token metadata and USD prices for one or more token addresses across chains","exampleAgentPrompt":"Can you look up the current USD price and metadata — symbol, decimals, and logo — for token address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 using Goldsky Feeds?","exampleUseCases":[{"title":"DeFi portfolio price tracker","prompt":"I have a list of ERC-20 token addresses in my portfolio — can you pull their current USD prices and symbols from Goldsky Feeds so I can calculate my total holdings value?"},{"title":"Token metadata enrichment for a dapp","prompt":"I need the token name, symbol, decimals, and logo URL for contract address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — can you grab that from Goldsky?"},{"title":"Cross-chain token price comparison","prompt":"What are the current USD prices for USDC and WETH across all chains that Goldsky Feeds has data for? Give me the addresses and last-priced timestamps too."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:16.383Z","isFirstParty":false,"canonicalSlug":"goldsky-feeds-token-prices-by-address-1a26d5c0"}