{"uid":"cap_sJTZCHPfSxIlZldbEZFXo","slug":"goldsky-feeds-polymarket-activity-0a9075eb","name":"Goldsky Feeds: Polymarket Activity","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/polymarket/activity?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_yudifJB_ElSOVBaz128Zl","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":"Fetches paginated activity data from Polymarket prediction markets via Goldsky's onchain data feed","exampleAgentPrompt":"Pull the latest activity from Polymarket — give me the most recent trades or market events, up to 20 results.","exampleUseCases":[{"title":"Monitor live Polymarket trading activity","prompt":"Show me the latest activity happening on Polymarket — what trades or market events have occurred most recently?"},{"title":"Paginate through historical market events","prompt":"I need to page through Polymarket activity data — fetch the next batch of events after the cursor I have from my last query."},{"title":"Build a Polymarket activity dashboard","prompt":"Continuously fetch the latest Polymarket prediction market activity so I can display a live feed of trades and events on my dashboard."}],"resultDescription":"Returns a JSON object with a 'data' array of activity records (trades, positions, market events), an integer 'limit' reflecting the page size, and a 'next_cursor' string (or null) for paginating through subsequent results.","failureModes":["Payment required (402) if prepaid balance is exhausted — top up USDC balance before retrying","Invalid or expired cursor returns empty or error response","Rate limiting if requests exceed allowed throughput","No data returned if no recent activity matches the filter","Network timeout if Goldsky edge infrastructure is under load"],"whenToPreferThis":"Choose this endpoint when you need structured, paginated access to Polymarket prediction market activity data from a reliable onchain data feed. Prefer it over direct blockchain RPC calls for ease of use, and over general-purpose indexers when you specifically need Polymarket activity. Best suited for agents that monitor prediction markets, build dashboards, or analyze trading behavior at low cost (~$0.005/call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:53.191Z","isFirstParty":false,"canonicalSlug":"goldsky-feeds-polymarket-activity-0a9075eb"}