Goldsky Feeds API – Chain Head Block

API ↗

Goldsky Feeds API – Chain Head Block is a paid API for AI agents from edge.goldsky.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns the current head block number, timestamp, and lag for a specified blockchain chain

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 chain identifier string, the current head block number as an integer, the Unix timestamp of that block as an integer, and the head_lag_seconds integer indicating how many seconds behind real-time the indexed head currently is.