端点清单

共 6 个端点，按用途分成 6 类。全部带 .php 后缀（本站没有配 URL rewrite）。人类可读的完整文档在接口文档；机器可读的索引在 /v1/index.php。

鉴权：除「站点信息」外，其余端点都要带 key —— X-Api-Key: pm_live_…，也支持 Authorization: Bearer …。没有 key 会返回 401 missing_api_key。注册后可在我的 API Key 里自助创建。

7 个市场都对开放：?market= 取值 btc · eth · sol · xrp · doge · hype · bnb （默认 btc）。
「行情快照」按市场取当前/指定窗口；「结算核对」「历史窗口」默认返回全部市场，传 market=eth 收敛到单个，传 market=all 或不传即全部。
CSV 里每行都带完整 slug（如 eth-updown-5m-1790401800），市场从 slug 前缀一眼可辨。

行情快照

GET /v1/window.php 当前 / 指定窗口快照 ★ 主力

返回一个 5 分钟窗口的实时快照：price to beat（官方 Chainlink TWAP60 开盘读数）、官方与现货距 beat 的基点、窗口剩余秒数、CLOB 盘口隐含概率、六家交易所逐个基点。

参数	必填	默认	说明
market	否	btc	市场：btc / eth / sol / xrp / doge / hype / bnb
slug	否	最新窗口	窗口标识，如 btc-updown-5m-1790389200
series	否	0	1 = 附带 2 秒时间序列。当前窗口任何套餐可用；历史窗口需样本权限
n	否	240	序列最多返回点数，1~2000，等距抽样且末点必留
raw	否	0	1 = 序列里含原始盘口字段（需 samples_raw 功能）

返回要点：price_to_beat / beat_source / beat_trusted / official_bp / spot_bp / leading_side / venue_bp / settled

curl -H "X-Api-Key: $KEY" \
  'https://api.wanminguo.top/quant/polymarket/v1/window.php'

curl -H "X-Api-Key: $KEY" \
  'https://api.wanminguo.top/quant/polymarket/v1/window.php?series=1&n=120'

结算核对

GET /v1/settle.php 结算结果 + 四条规则读数历史天数

返回窗口的官方结算 outcome，以及四条候选结算规则（A/B/C/D）各自的判定与四个原始价（so/sc/to/tc）—— 你可以自己复算，不用信我。

参数	必填	默认	说明
market	否	all	默认全部市场；传 eth 等收敛到单个
slug	否	—	单个窗口的结算记录
last	否	20	最近 N 个已结算窗口

返回要点：outcome / rules（A B C D agree gap_bp move_bp so sc to tc）/ fam

curl -H "X-Api-Key: $KEY" \
  'https://api.wanminguo.top/quant/polymarket/v1/settle.php?last=5'

历史窗口

GET /v1/history.php 窗口列表（可回溯天数由套餐决定）历史天数

按时间范围列出窗口，每项含 slug / 开盘时间 / 结算结果 / 样本条数。新的在前，带 older_available 便于翻页。★ 范围超限会整体 403，不做静默截断 —— 少给数据不报错比报错更糟。

参数	必填	默认	说明
market	否	all	默认全部市场；传 eth 等收敛到单个
from / to	否	不限	unix 秒，或 2026-09-22 这样的日期串
limit	否	min(200, 套餐上限)	单次最多返回窗口数
offset	否	0	分页
compact	否	0	1 = 只返回 slug/window_start/outcome/n_samples

返回要点：count / total / older_available / windows[]

curl -H "X-Api-Key: $KEY" \
  'https://api.wanminguo.top/quant/polymarket/v1/history.php?from=2026-09-25&compact=1'

原始样本

GET /v1/samples.php 原始 2 秒样本（最贵的端点）样本权限

直接给出采集到的 2 秒粒度原始记录。体积最大、最容易被整份拿去回测，所以单独一道付费墙：套餐 max_samples_per_call = 0 时该端点整体禁用。

参数	必填	默认	说明
slug	是	—	必填
limit	否	min(200, 套餐上限)	单次最多条数
offset	否	0	分页
tail	否	0	1 = 取最后 N 条（做实时最常用）
raw	否	0	1 = 原始 JSONL 字段；否则返回加工后的字段

返回要点：count / total / samples[]

curl -H "X-Api-Key: $KEY" \
  'https://api.wanminguo.top/quant/polymarket/v1/samples.php?slug=<SLUG>&tail=1&limit=60'

统计汇总

GET /v1/stats.php 预聚合统计（免费档可用）免费档可用

返回采集器算好的定长摘要：窗口数、结算数、四规则分歧数，以及按族聚合的样本数 / 胜率 / 均价 / 净 EV。用来快速判断数据质量与规则表现，不用自己重算。

返回要点：health / summary.fam / rule_rows[]

curl -H "X-Api-Key: $KEY" \
  'https://api.wanminguo.top/quant/polymarket/v1/stats.php'

站点信息（免 key）

GET /v1/index.php 端点索引 + 套餐表（机器可读）不需要 key

给程序自查用：JSON 格式的端点清单、错误码表、当前生效的套餐与价格。不需要 key，也不含任何行情数据。人看的话就用本页。

返回要点：endpoints[] / error_codes / plans[] / health

curl 'https://api.wanminguo.top/quant/polymarket/v1/index.php'

响应信封与错误码

成功：{ ok: true, data: {…}, meta: { endpoint, plan, quota{mode, daily_limit:null}, limits, feed, server_ts } }
失败：{ ok: false, error: "code", message: "…" }
meta.quota.mode = "subscription"（信号订阅制：无请求配额，额度按成交股数扣，见 meta.credits）。

HTTP	error	含义
400	missing_param / bad_slug / bad_param	参数缺失或非法
401	missing_api_key / invalid_api_key	没带 key / key 不存在
403	key_revoked / key_expired / customer_inactive / plan_retired	key 或套餐已停用
403	history_not_in_plan / history_depth_exceeded	套餐不含历史，或请求窗口超出可回溯天数（当前窗口永远可访问）
403	samples_not_in_plan / plan_feature_denied	套餐不含原始样本 / 不含该功能开关
404	window_not_found / settle_not_found	没有该窗口的数据
429	rate_limited	同一秒请求过多（秒级防护，20 qps 上限）—— 稍等 1 秒重试即可。信号订阅无请求配额。
503	feed_root_missing / no_window / billing_db_unavailable	服务端数据或计费库不可用

套餐

code	名称	U/月	QPS	请求配额	历史	窗口/次	样本/次
free	免费	免费	1	不限（按成交股数扣额度）	1 天	20	—
basic	基础	29.00	5	不限（按成交股数扣额度）	7 天	200	200
pro	专业	129.00	60	不限（按成交股数扣额度）	90 天	2,000	2,000
internal	自用	免费	500	不限（按成交股数扣额度）	3650 天	100,000	100,000

· 信号订阅制：无请求配额，额度按**成交股数**扣（1 股 = 1 额度，纸面回执不扣）。
· history_days = 0 表示只能访问当前窗口。
· 付费套餐需要开通后由管理员指派，免费档可以在我的 API Key 自助创建。