Search Polymarket events and read market outcome prices, order books, price history and trades in USDC. Look up traders by @handle or wallet for profit and loss, positions, activity and leaderboard ranks, and read event comment threads.
WHAT YOU CAN BUILD / 13 ENDPOINTS
Find your use case, then explore the request and response.
/v1/polymarket/searchBuild a market search from matching events with each market’s outcomes, outcome prices, best bid and ask, spread and last trade price, plus matching tags and trader profiles when requested.
/v1/polymarket/eventsBuild a trending-markets board sorted by volume, liquidity, open interest or competitiveness, filtered by tag, status, size and dates, with each event’s market summaries. Continue with the returned cursor.
/v1/polymarket/eventBuild an event page with its rules, resolution source, USDC volume and liquidity totals, tags, series and every market’s outcomes, prices and token IDs.
/v1/polymarket/marketBuild a market detail card with the question, rules, outcome prices, best bid and ask, spread, USDC volume and liquidity, and one-hour to one-month price changes.
/v1/polymarket/orderbookBuild a depth chart for one outcome from every bid and ask level, with the best bid and ask, tick size, minimum order size and last trade price.
/v1/polymarket/price-historyBuild an outcome price chart from timestamped prices over a relative interval or a start and end time, with the bucket width you choose. Continue with the returned cursor.
/v1/polymarket/tradesBuild a trade feed for a market, event or trader with side, size, price, outcome, market title and the trader’s public profile. Filter by side and minimum size and continue with the returned cursor.
/v1/polymarket/commentsBuild a discussion view of an event or series thread with comment text, replies, reaction counts and commenter profiles, optionally from position holders only. Continue with the returned cursor.
/v1/polymarket/profileBuild a trader card from an @handle or wallet with the public profile, markets traded, biggest win, views, join date, all-time profit and loss, portfolio value and leaderboard ranks.
/v1/polymarket/user-positionsBuild a portfolio tracker from a trader’s open, closed or redeemable positions with size, average and current price, value, cost and realized and unrealized profit and loss.
/v1/polymarket/user-activityBuild a wallet activity timeline of trades, splits, merges, redemptions, rewards and conversions with USDC amounts, prices and the market each row belongs to. Continue with the returned cursor.
/v1/polymarket/holdersBuild a top-holders table for each outcome of a market with share balances and the holders’ public names, profile images and verified status.
/v1/polymarket/leaderboardBuild a trader ranking by profit or volume for a day, week, month or all time, overall or in one category, with USDC profit and loss, volume and profile details.
HOW IT WORKS
Run a sample below without a key.
Create a free account and copy your key. You start with 100 free credits; no card needed.
Pick one of the 13 Polymarket endpoints and add its input, such as a search query.
Call it with your key in the x-api-key header. ScrapeAtlas reads the public Polymarket data and retries when a read fails.
Get structured JSON with a coverage status. Only successful requests use a credit.
LIVE RESULTS
Try the Polymarket API right here. This sample uses the Search Polymarket endpoint and returns live JSON. No API key needed.
Start with world cup, or change the query field to your own value.
Execute the sample code and see the response in the JSON response tab.
Open the full playground to try more parameters and copy code for your app.
// Run this sample here — no API key needed.
const value = "world cup";
const url = new URL("/website/demo/polymarket",
"https://api.scrapeatlas.com");
url.searchParams.set("value", value);
const response = await fetch(url);
const data = await response.json();
console.log(data);Run the sample to see the live JSON response here./v1/polymarket/searchA live example from our playground. Change the value above, then select Run sample.
CUSTOMER STORIES
Watch Nigel’s story
Watch Janu’s storyEmail Viktor with a testimonial & receive 10,000 free credits.
Pay as you go
One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.
Try the API with your next idea.
$0No credit card needed
100 free credits
One starter grant per account
For a new idea or a one-off project.
$19USD / one-time
10,000 credits
$1.90 per 1,000 credits
For regular workflows and bigger builds.
$89USD / one-time
50,000 credits
$1.78 per 1,000 credits
Save 6.3% compared with Starter
For high-volume data collection.
$249USD / one-time
200,000 credits
$1.25 per 1,000 credits
Save 34.5% compared with Starter
Enterprise Plan
Let’s talk about a plan that fits your scale.
Polymarket API
Search Polymarket events and read events and markets with outcome prices, token IDs, volume and liquidity in USDC. Read live order books, price history, trades and comment threads, and look up traders by @handle or wallet for their profile, positions, activity, the largest market holders and the leaderboard.
Pass a market slug, ID or URL to Market for each outcome’s price from 0 to 1, the best bid and ask, spread, last trade price and price changes over the past hour, day, week and month. Event returns the prices of every market in an event, and Order Book returns every bid and ask level for one outcome.
Yes. Price History returns timestamped prices for one outcome over a relative interval such as one week or all time, or between a start and end time. Set bucketSeconds for the point width and follow the returned cursor for longer ranges. Trades adds individual fills with side, size, price and time.
Leaderboard ranks traders by profit or volume in USDC for a day, week, month or all time, overall or in a category such as politics, sports or crypto. Each entry includes rank, trading wallet, name, profile image and verified status. Follow the returned cursor for more ranks.
Trades lists recent trades for a market, an event or a trader, newest first, with side, size in shares, price, outcome, market title and the trader’s public profile. Filter by side and minimum size in shares or USDC, and set a time window when you request a trader’s trades.
Pass an @handle, wallet or profile URL to Profile for all-time profit and loss, portfolio value and leaderboard ranks. Positions lists open or closed positions with average and current price, value and profit and loss, and Activity lists trades, redemptions and rewards with USDC amounts, newest first.
Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.
Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.
Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.
MORE PLATFORMS
Make something with it
Bring social data into your next project.
Start with 100 free credits and see what you can build.
We use essential storage to keep the site working. With your permission, optional analytics and ad-measurement cookies help us understand visits and which Google and ChatGPT ads lead to signups and purchases. You can change your choice anytime. Privacy policy
Google Analytics and PostHog measure visits, page engagement, signup-link clicks and website performance on public pages. With separate ad-measurement consent, Google Analytics records confirmed signups and actual paid credit-pack purchases, including purchase value and currency. Google stores ad-click attribution cookies. OpenAI also measures confirmed signups and credit purchases and may match supported customer information using browser-side hashes. Rejecting optional cookies does not affect access to the site.
Allow Affonso to record your referral visit and store a cookie for 30 days. If you sign up, we share your verified email with Affonso to attribute purchases. Privacy policy
