PolymarketPrediction Markets
Hỗ trợ backtest AI, ứng dụng copy-trading và dashboard danh mục bằng dữ liệu on-chain Polygon được làm giàu bằng metadata Polymarket. Là một phần của Token API.
- ✓Endpoint REST chỉ đọc cho markets, OHLCV, open interest, hoạt động, vị thế và tổng hợp nền tảng
- ✓Dữ liệu sự kiện on-chain từ Polygon, được làm giàu bằng scraper Polymarket
- ✓Mở rộng từ script nghiên cứu một lần đến agent giao dịch luôn bật
Bạn nhận được gì với Prediction Markets API
Endpoint REST
Markets, OHLCV, OI, activity, positions, platform, users
Polygon on-chain
Trades, splits, merges, redemptions — ở cấp giao dịch
P&L theo người dùng
PNL đã thực hiện và chưa thực hiện, cost basis, giá hiện tại
Làm mới theo giờ
Bảng xếp hạng tổng hợp cập nhật liên tục
24-hour macro
Six complete 4-hour buckets, 2026-04-25 16:00 → 2026-04-26 12:00 UTC. Partial current window excluded.
Hot markets
Highest-volume Polymarket markets to date, sorted by lifetime notional. Queried live via /v1/polymarket/markets.
- 01
Will Jesus Christ return before 2027?
Nov 25, 2025 → Dec 31, 2026·Active·YesNo$58.7MLifetime vol - 02
Will LeBron James win the 2028 US Presidential Election?
Jul 11, 2025 → Nov 7, 2028·Active·YesNo$48.6MLifetime vol - 03
Will the Fed decrease interest rates by 50+ bps after the April 2026 meeting?
Nov 13, 2025 → Apr 29, 2026·Active·YesNo$45.0MLifetime vol - 04
Will Tim Walz win the 2028 US Presidential Election?
Jul 11, 2025 → Nov 7, 2028·Active·YesNo$40.4MLifetime vol - 05
Will Mike Pence win the 2028 Republican presidential nomination?
Jul 11, 2025 → Nov 7, 2028·Active·YesNo$39.1MLifetime vol - 06
Will Byron Donalds win the 2028 Republican presidential nomination?
Jul 11, 2025 → Nov 7, 2028·Active·YesNo$37.0MLifetime vol - 07
Will Kim Kardashian win the 2028 US Presidential Election?
Jul 11, 2025 → Nov 7, 2028·Active·YesNo$33.9MLifetime vol - 08
Will the Iranian regime fall by June 30?
Dec 17, 2025 → Jun 30, 2026·Active·YesNo$33.0MLifetime vol
Volume, bucketed
Each bar is a complete 4-hour window. Peak activity at 2026-04-25 16:00 UTC.
$137.94M / 24h
Sum of buy + sell volume across the 6 complete buckets. Peak bucket $32.14M (2026-04-25 16:00). Bucket average $22.99M.
Hourly breakdown
Exact response, newest first. Partial current bucket excluded from totals.
| Bucket (UTC) | Volume | Buy | Sell | Trades | Net OI | Fees | Rate |
|---|---|---|---|---|---|---|---|
| 2026-04-26 12:00 | $30,813,105 | $6,630,116 | $24,182,989 | 433,530 | $47,494,585 | $4,984,993 | 16.18% |
| 2026-04-26 08:00 | $20,259,101 | $5,086,437 | $15,172,663 | 359,139 | $30,485,419 | $3,319,163 | 16.38% |
| 2026-04-26 04:00 | $13,001,058 | $2,499,122 | $10,501,936 | 323,287 | $15,291,837 | $1,710,103 | 13.15% |
| 2026-04-26 00:00 | $19,123,704 | $4,798,572 | $14,325,131 | 379,441 | $21,410,988 | $3,401,421 | 17.79% |
| 2026-04-25 20:00 | $22,608,271 | $5,613,595 | $16,994,676 | 424,994 | $27,383,699 | $4,694,435 | 20.76% |
| 2026-04-25 16:00 | $32,139,710 | $7,526,366 | $24,613,344 | 458,545 | $41,646,972 | $6,552,765 | 20.39% |
Cách các nhóm sử dụng
Ba mẫu phổ biến nhất. Mỗi mẫu dùng một tập con các endpoint — bạn có thể kết hợp tùy nhu cầu.
01
Backtest giao dịch AI
Phát lại diễn biến giá lịch sử theo outcome token và kiểm thử chiến lược với các sự kiện thanh khoản thực. Kết hợp OHLCV với activity feed để dựng lại fill và phí từng thanh.
- GET/v1/polymarket/markets/ohlc
- GET/v1/polymarket/markets/activity
[
{
"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
Theo dõi top trader từ bảng xếp hạng người dùng và sao chép các điểm vào / ra của họ. Activity feed phát mọi giao dịch, split, merge và redemption với thời gian cấp block.
- GET/v1/polymarket/users
- GET/v1/polymarket/markets/activity
[
{
"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
P&L danh mục người dùng
Xây dashboard ví và xuất thuế hiển thị những gì người dùng nắm giữ trên mọi outcome token — với cost basis, giá hiện tại và PNL đã thực hiện vs chưa thực hiện.
- GET/v1/polymarket/users/positions
- GET/v1/polymarket/markets/positions
[
{
"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
}
}
]Endpoint REST
Xem tài liệu chính thức: https://app.pinax.network/docs
Markets
5 endpointsUsers
2 endpointsPlatform
1 endpointCách hoạt động
Cùng mẫu với phần còn lại của Token API — lấy API key, gọi endpoint, parse JSON.
Yêu cầu thông tin API từ Pinax
Chọn endpoint phù hợp với use case
Gọi từ ứng dụng, notebook hoặc client MCP của bạn
Triển khai chiến lược, dashboard hoặc agent
Câu hỏi thường gặp
Same data, one endpoint.
Platform, markets, users, OHLC — all under /v1/polymarket/*. Free tier starts at 100 req/s.
