Pinax
登录联系我们

博客
Prediction Market APIPolymarket

Prediction Markets

生产级 Polymarket 数据 — 市场、价格、活动与 P&L — 统一 HTTP API

使用 Polymarket 元数据增强的链上 Polygon 数据,驱动 AI 交易回测、跟单交易应用和投资组合仪表盘。是 Token API 的一部分。

  • 覆盖市场、OHLCV、未平仓合约、活动、持仓和平台聚合的只读 REST 端点
  • 来自 Polygon 的链上事件数据,由 Polymarket 抓取器元数据增强
  • 从一次性研究脚本扩展到常开的交易 agent

您从 Prediction Markets API 获得什么

REST 端点

Markets, OHLCV, OI, 活动, 持仓, 平台, 用户

Polygon 链上

交易、拆分、合并、赎回 — 交易级别

按用户 P&L

已实现与未实现 PNL、成本基础、当前价格

按小时刷新

预聚合排行榜持续更新

// 01 · Headline metrics

24-hour macro

Six complete 4-hour buckets, 2026-04-25 04:002026-04-26 00:00 UTC. Partial current window excluded.

Net open interest · peak bucket -19.2% over window
$41.65M
Outcome-share liquidity locked at 2026-04-25 16:00 UTC — the highest of the window. Bucket average $28.64M · 24h OI flow $171.86M.
Buy vs. sell volume · 24h
3.02×Sell-side dominated every bucket. $105.99M sold vs $35.06M bought across $141.05M of total notional.
24.9%BUY
SELL75.1%
Buy volume$35.06M
Sell volume$105.99M
Total fees18.14%
$25.58M
Vol-weighted rate.
Total trades↗ 104.4k/hr
2.51M
460.8k buys · 2.04M sells.
Avg trade size6 buckets
$56.30
Volume / trades. Sell-weighted.
OI transactionssplit/merge
3.86M
3.59M splits · 264.6k merges.
// hot markets · all-time

Hot markets

Highest-volume Polymarket markets to date, sorted by lifetime notional. Queried live via /v1/polymarket/markets.

  1. 01

    Will Jesus Christ return before 2027?

    Nov 25, 2025Dec 31, 2026ActiveYesNo
    $58.7M
    Lifetime vol
  2. 02

    Will LeBron James win the 2028 US Presidential Election?

    Jul 11, 2025Nov 7, 2028ActiveYesNo
    $48.6M
    Lifetime vol
  3. 03

    Will the Fed decrease interest rates by 50+ bps after the April 2026 meeting?

    Nov 13, 2025Apr 29, 2026ActiveYesNo
    $45.0M
    Lifetime vol
  4. 04

    Will Tim Walz win the 2028 US Presidential Election?

    Jul 11, 2025Nov 7, 2028ActiveYesNo
    $40.4M
    Lifetime vol
  5. 05

    Will Mike Pence win the 2028 Republican presidential nomination?

    Jul 11, 2025Nov 7, 2028ActiveYesNo
    $39.1M
    Lifetime vol
  6. 06

    Will Byron Donalds win the 2028 Republican presidential nomination?

    Jul 11, 2025Nov 7, 2028ActiveYesNo
    $37.0M
    Lifetime vol
  7. 07

    Will Kim Kardashian win the 2028 US Presidential Election?

    Jul 11, 2025Nov 7, 2028ActiveYesNo
    $33.9M
    Lifetime vol
  8. 08

    Will the Iranian regime fall by June 30?

    Dec 17, 2025Jun 30, 2026ActiveYesNo
    $33.0M
    Lifetime vol
// 02 · Flow over time

Volume, bucketed

Each bar is a complete 4-hour window. Peak activity at 2026-04-25 16:00 UTC.

Traded volume · stacked buy / sell

$141.05M / 24h

Sum of buy + sell volume across the 6 complete buckets. Peak bucket $32.14M (2026-04-25 16:00). Bucket average $23.51M.

BuySell
$0$9M$18M$26M$35M04:00Apr 2508:0012:0016:0020:0000:00Apr 26
avg bucket $23.51Mpeak 2026-04-25 16:00 · $32.14Mlow 2026-04-25 04:00 · $15.38M
// 03 · Raw buckets

Hourly breakdown

Exact response, newest first. Partial current bucket excluded from totals.

Bucket (UTC)VolumeBuySellTradesNet OIFeesRate
2026-04-26 00:00$19,123,704$4,798,572$14,325,131379,441$21,410,988$3,401,42117.79%
2026-04-25 20:00$22,608,271$5,613,595$16,994,676424,994$27,383,699$4,694,43520.76%
2026-04-25 16:00$32,139,710$7,526,366$24,613,344458,545$41,646,972$6,552,76520.39%
2026-04-25 12:00$28,944,842$7,818,279$21,126,563460,686$29,340,222$5,201,75417.97%
2026-04-25 08:00$22,850,734$5,631,600$17,219,134417,237$25,590,218$3,355,30114.68%
2026-04-25 04:00$15,384,232$3,676,207$11,708,025364,262$26,492,072$2,374,40015.43%
6 rows · complete buckets only · usdc 6dp normalizedquery 32 ms · refreshes ≤ 60s

团队如何使用

最常见的三种模式。每种都使用端点的一个子集 — 可以按需混用。

01

AI 交易回测

按结果代币重放历史价格走势,并针对真实流动性事件对策略进行压力测试。将 OHLCV 与活动流结合,可以逐条重建成交与费用。

  • GET/v1/polymarket/markets/ohlc
  • GET/v1/polymarket/markets/activity
Sample response
[
  {
    "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

跟单交易

关注用户排行榜上的头部交易者并镜像他们的开平仓。活动流以区块级时序发出每一笔交易、拆分、合并与赎回。

  • GET/v1/polymarket/users
  • GET/v1/polymarket/markets/activity
Sample response
[
  {
    "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

为钱包仪表盘和税务导出构建视图,展示用户在所有 Polymarket 结果代币上的持仓 — 含成本基础、当前价格、已实现 vs 未实现 PNL。

  • GET/v1/polymarket/users/positions
  • GET/v1/polymarket/markets/positions
Sample response
[
  {
    "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 端点

查看官方文档: https://app.pinax.network/docs

Markets

5 endpoints
GET/v1/polymarket/markets
FREE
GET/v1/polymarket/markets/ohlc
GET/v1/polymarket/markets/oi
GET/v1/polymarket/markets/activity
GET/v1/polymarket/markets/positions

Users

2 endpoints
GET/v1/polymarket/users
GET/v1/polymarket/users/positions

Platform

1 endpoint
GET/v1/polymarket/platform

工作原理

与 Token API 其余部分相同 — 获取 API 密钥、调用端点、解析 JSON。

1

向 Pinax 申请 API 凭证

2

为您的使用场景选择端点

3

从应用、notebook 或 MCP 客户端调用

4

部署您的策略、仪表盘或 agent

常见问题

Same data, one endpoint.

Platform, markets, users, OHLC — all under /v1/polymarket/*. Free tier starts at 100 req/s.

订阅我们的 Newsletter 新闻通讯

立即注册,了解我们为您的链提供的测试计划。