Prediction Markets
Power AI trading backtests, copy-trading apps, and portfolio dashboards with on-chain Polygon data enriched with Polymarket metadata. Part of the Token API.
- ✓Read-only REST endpoints covering markets, OHLCV, open interest, activity, positions, and platform aggregates
- ✓On-chain event data from Polygon, enriched with Polymarket scraper metadata
- ✓Scales from one-off research scripts to always-on trading agents
What you get with the Prediction Markets API
REST endpoints
Markets, OHLCV, OI, activity, positions, platform, users
Polygon on-chain
Trades, splits, merges, redemptions — at the tx level
Per-user P&L
Realized and unrealized PNL, cost basis, current price
Hourly refresh
Aggregated leaderboards updated continuously
24-hour macro
Six complete 4-hour buckets as of 2026-04-28.
Queried live via /v1/polymarket/platform.
BTC Direction Market vs Spot Price
Polymarket Up probability against Hyperliquid BTC OHLCV over the active Polymarket trading window.
Cached live requests via /v1/polymarket/markets/ohlc and /v1/hyperliquid/markets/ohlc.
Bitcoin Up or Down on May 4?
bitcoin-up-or-down-on-may-4-2026 / 2026-05-03 16:00 to 2026-05-04 16:00 UTC / $202.1k Polymarket volume / 3,394 trades. Peak bucket $15.7k at 2026-05-04 15:30 UTC.
Largest Volume
Highest-volume Polymarket markets to date, sorted by lifetime notional.
Queried live via /v1/polymarket/markets.
- 01
Will Donald Trump win the 2024 US Presidential Election?
Jan 4, 2024 → Nov 5, 2024·Resolved·YesNo$1.53BLifetime vol - 02
Will Kamala Harris win the 2024 US Presidential Election?
Jan 4, 2024 → Nov 4, 2024·Resolved·YesNo$1.04BLifetime vol - 03
Will Donald Trump be inaugurated?
Nov 1, 2024 → Jan 20, 2025·Resolved·YesNo$400.4MLifetime vol - 04
Will the Sacramento Kings win the 2025 NBA Finals?
Sep 24, 2024 → Jun 23, 2025·Resolved·YesNo$378.0MLifetime vol - 05
Will Nicolae Ciucă win the 2024 Romanian Presidential election?
Nov 8, 2024 → Dec 8, 2024·Resolved·YesNo$326.5MLifetime vol - 06
US forces enter Iran by April 30?
Mar 18, 2026 → Apr 30, 2026·Resolved·YesNo$269.0MLifetime vol - 07
Will Zelenskyy wear a suit before July?
May 22, 2025 → Jun 30, 2025·Resolved·YesNo$242.2MLifetime vol - 08
Will any other Republican Politician win the 2024 US Presidential Election?
Jan 6, 2024 → Nov 5, 2024·Resolved·YesNo$241.7MLifetime vol
Volume, bucketed
Each bar is a complete 4-hour window. Peak activity at 2026-04-27 00:00 UTC.
Queried live via /v1/polymarket/platform.
$101.57M / 24h
Sum of buy + sell volume across the 6 complete buckets. Peak bucket $19.14M (2026-04-27 00:00). Bucket average $16.93M.
Hourly breakdown
Exact response, newest first. Partial current bucket excluded from totals.
Queried live via /v1/polymarket/platform.
| Bucket (UTC) | Volume | Buy | Sell | Trades | Net OI | Fees | Rate |
|---|---|---|---|---|---|---|---|
| 2026-04-27 20:00 | $15,982,059 | $3,717,450 | $12,264,609 | 368,265 | $26,205,188 | $3,323,378 | 20.79% |
| 2026-04-27 16:00 | $18,685,495 | $4,851,775 | $13,833,720 | 452,601 | $23,637,381 | $3,030,330 | 16.22% |
| 2026-04-27 12:00 | $18,191,524 | $4,575,783 | $13,615,741 | 483,519 | $22,732,012 | $2,991,649 | 16.45% |
| 2026-04-27 08:00 | $14,449,844 | $3,992,274 | $10,457,570 | 393,784 | $14,592,574 | $2,055,906 | 14.23% |
| 2026-04-27 04:00 | $15,118,589 | $4,261,722 | $10,856,867 | 426,382 | $17,283,728 | $1,896,990 | 12.55% |
| 2026-04-27 00:00 | $19,138,894 | $4,605,181 | $14,533,713 | 410,331 | $26,718,180 | $3,393,582 | 17.73% |
How teams use it
Three patterns we see most often. Each uses a small subset of the endpoints — you can mix them as needed.
01
AI Trading Backtesting
Replay historical price action per outcome token and stress-test strategies against real liquidity events. Combine OHLCV with the activity feed to reconstruct fills and fees bar-by-bar.
[
{
"timestamp": "2026-04-01 00:00:00",
"open": 0.997,
"high": 0.998,
"low": 0.997,
"close": 0.998,
"volume": 295143.37,
"trades": 1206,
"buys": 498,
"sells": 708,
"unique_makers": 592,
"unique_takers": 121,
"total_fees": 0,
"fee_count": 0,
"effective_fee_rate": 0,
"market": {
"condition_id": "0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c",
"market_slug": "will-the-portland-trail-blazers-win-the-2026-nba-finals",
"token_id": "48262548906086150698299934962091284390063927164151224719187427455086357699251",
"outcome_label": "No",
"closed": false
}
}
]02
Copy Trading
Watch the top traders from the user leaderboard and mirror their entries and exits. The activity feed emits every trade, split, merge, and redemption with block-level timing so you can react in near real-time.
[
{
"event_type": "trade",
"timestamp": "2026-04-02 16:51:31",
"block_num": 85014327,
"tx_hash": "0xf190865afd395e2f4b8f2e5f8ceb2c05a86d94a73ea411e8a8a3fc649924c420",
"user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
"amount": "3976744",
"value": 3.98,
"fee_amount": "526315",
"fee_value": 0.53,
"market": {
"condition_id": "0xcb37916b953e6b37a5be32ceabc5a093614be15d9e6abb7668bf6400fbf36d46",
"market_slug": "bitcoin-up-or-down-on-april-3-2026",
"token_id": "3861173442961229042274748637211736540847931193208187121747580704941582603312",
"outcome_label": "Down",
"closed": false
}
}
]03
User Portfolio P&L
Build wallet dashboards and tax exports that show what a user holds across every Polymarket outcome token — with cost basis, current price, and realized vs unrealized PNL.
[
{
"user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
"buy_cost": 6438.35,
"sell_revenue": 247.09,
"realized_pnl": -6191.26,
"unrealized_pnl": 9005.64,
"total_pnl": 2814.38,
"pnl_pct": -0.96,
"net_position": 9096.61,
"avg_price": 0.68,
"current_price": 0.99,
"position_value": 9005.64,
"active": true,
"buys": 693,
"sells": 20,
"transactions": 713,
"market": {
"condition_id": "0x59feadddd58e7821c086ee9f3dc4f544514b94ebd0e8d645a3c4d80ebdd354a2",
"market_slug": "btc-updown-5m-1771359600",
"token_id": "25362470215305294361999917933416973453076214567033270695579745712197481070383",
"outcome_label": "Up",
"closed": false
}
}
]REST endpoints
See official docs: https://app.pinax.network/docs/prediction-markets
Markets
5 endpointsPlatform
1 endpointHow it works
Same pattern as the rest of the Token API — issue an API key, hit the endpoint, parse the JSON.
Request API credentials from Pinax
Pick the endpoint for your use case
Call it from your app, notebook, or MCP client
Ship your strategy, dashboard, or agent
Frequently Asked Questions
Same data, one endpoint.
Platform, markets, users, OHLC — all under /v1/polymarket/*. Free tier starts at 100 req/s.