{"uid":"cap_ANAhPa3ELhR3yrCk3-PnH","slug":"goldsky-feeds-polymarket-positions-76f4df87","name":"Goldsky Feeds - Polymarket Positions","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/positions?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":["address"],"properties":{"sort":{"type":["string","null"]},"limit":{"type":["integer","null"]},"cursor":{"type":["string","null"]},"address":{"type":"string"},"token_id":{"type":["string","null"]},"min_amount":{"type":["string","null"]},"include_zero":{"type":["boolean","null"]}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","limit"],"properties":{"data":{"type":"array","items":{"type":"object","required":["address","token_id"],"properties":{"amount":{"type":["string","null"]},"address":{"type":"string"},"token_id":{"type":"string"},"avg_price":{"type":["string","null"]},"block_number":{"type":["integer","null"]},"realized_pnl":{"type":["string","null"]},"total_bought":{"type":["string","null"]},"last_updated_at":{"type":["number","null"]}}}},"limit":{"type":"integer"},"next_cursor":{"type":["string","null"]}}}}}}},"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_r1cLDbJqYo3Q9cMRPiGHY","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":"Retrieve a wallet address's current prediction market positions on Polymarket, including amounts, average prices, and realized PnL","exampleAgentPrompt":"Show me all current Polymarket positions for wallet address 0xABCD1234... — include the average price and realized PnL for each, and return up to 50 results.","exampleUseCases":[{"title":"Portfolio check for Polymarket trader","prompt":"Pull all the Polymarket positions held by wallet 0xDEADBEEF... and show me the amount, average entry price, and any realized profit or loss for each one."},{"title":"Filter out dust positions","prompt":"Get Polymarket positions for address 0x1234ABCD... but only show ones with at least 10 USDC worth — I want to ignore the tiny zero or near-zero holdings."},{"title":"Track a specific outcome token holding","prompt":"Look up how much of token ID 71321045873 wallet 0xCAFEBABE... is holding on Polymarket and what price they paid on average."}],"resultDescription":"Returns a paginated list of prediction market positions for the queried wallet address. Each position includes the wallet address, token ID, amount held, average purchase price, total bought, realized PnL, block number of the last update, and a last-updated timestamp. The response also includes a limit and a next_cursor for pagination through large result sets.","failureModes":["Missing required 'address' query parameter returns a 400 or validation error","Invalid wallet address format may return empty data or an error","Payment not sent or insufficient prepaid balance returns a 402 Payment Required","Rate limiting or balance exhaustion halts requests mid-pagination","Very large position histories may require multiple paginated requests using next_cursor","Token ID filter with no matching positions returns an empty data array"],"whenToPreferThis":"Use this endpoint when you need onchain Polymarket position data for a specific wallet address — including amounts, average prices, and realized PnL — sourced directly from Goldsky's indexed chain data. Prefer this over generic blockchain explorers when you need structured, queryable prediction market position data with pagination support and optional filtering by token or minimum amount.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:47.452Z","isFirstParty":false,"canonicalSlug":"goldsky-feeds-polymarket-positions-76f4df87"}