{"uid":"cap_otwzuBV1P5Sb-2SZGVD_t","slug":"goldsky-feeds-api-blocks-by-chain-9f5f28ff","name":"Goldsky Feeds API – Blocks by Chain","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/blocks/%7Bchain%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"data":{"type":"array"},"limit":{"type":"integer"},"next_cursor":{"type":["string","null"]}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WW01ElnuShLM-IKu2TxIs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of recent blocks for a specified blockchain, including block metadata and chain state.","exampleAgentPrompt":"Fetch me the latest blocks on Ethereum using Goldsky Feeds so I can see recent block heights, timestamps, and hashes — return up to 20 results.","exampleUseCases":[{"title":"Monitor real-time block production","prompt":"Can you pull the last 10 blocks produced on Polygon from Goldsky Feeds and tell me the block numbers, timestamps, and hashes?"},{"title":"Audit block history for a chain","prompt":"I need to review recent block data on Base — fetch me a paginated list of blocks from Goldsky Feeds so I can check block heights and timestamps across the last batch."},{"title":"Sync chain state in a data pipeline","prompt":"Pull the latest block batch from Optimism via Goldsky Feeds and give me the cursor so my pipeline can pick up where it left off next time."}],"resultDescription":"Returns a JSON object with a `data` array of block objects (containing block number, hash, timestamp, and chain metadata), an integer `limit` field, and a `next_cursor` string (or null) for pagination to the next page of results.","failureModes":["401 Unauthorized if the API key is invalid or missing","Unknown or unsupported chain identifier returns an error or empty result","Rate limiting if requests exceed allowed throughput","Malformed request parameters may return 400 Bad Request","next_cursor may be null when no more pages are available"],"whenToPreferThis":"Choose this endpoint when you need raw block-level data (block numbers, hashes, timestamps) for a specific blockchain over REST without running a full node or setting up a subgraph. Ideal for lightweight chain monitoring, data pipelines, or auditing block production history. Prefer this over RPC-based block fetching when you want a simple paginated REST interface with consistent JSON output and no node infrastructure overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:37:53.431Z","isFirstParty":false,"canonicalSlug":"goldsky-feeds-api-blocks-by-chain-9f5f28ff"}