pdata-client:跨平台预测市场数据客户端与样本
数据集简介
关于 pdata-client
pdata-client 是 pdata.world 的配套 Python 客户端、示例与样本数据仓库,由 GitHub 用户 noskillcoding 维护。pdata.world 本身是一个免费、只读的预测市场数据 API,覆盖 Polymarket、Kalshi、Manifold、Myriad、Limitless、Predict、Opinion、Gemini 八个平台。它每 10–60 分钟轮询各平台一次,将价格、24 小时成交量和结果统一到同一 schema 下,方便研究者跨平台横向比较。
仓库中的客户端仅依赖 Python 标准库,不引入第三方依赖,便于在受限环境中直接运行。
安装
客户端实现位于 src/pdata/client.py,可直接复制到项目中,或按仓库说明以模块方式引入。示例脚本放在 examples/ 目录,包括 quickstart.py、resolved_archive.py、postgres.sql 与 mcp.json,分别对应快速上手、已结算数据归档、Postgres 查询与 MCP 配置。
客户端覆盖的内容
客户端面向 pdata.world 的 JSON API(api.pdata.world/api/v1)封装常用读取操作,返回的市场与事件记录包含统一字段,例如 source、probability、event_title、question、volume_24hr。字段含义与单位在每份数据文件首行的 manifest 中声明。
其他获取同一数据的方式
除 Python 客户端外,pdata.world 还提供多种获取途径:
- MCP 服务:可通过
examples/mcp.json配置接入。 - 每晚批量文件:位于
api.pdata.world/bulk/,每晚重建,保留最近 7 晚,行数与校验和见index.json。 - Hugging Face 与 Kaggle 月度快照:以 Parquet 格式发布。
- Zenodo 归档:DOI 为 10.5281/zenodo.23211610。
- 公开只读 Postgres:查询上限 5 秒。
- 网站:直接浏览。
所有方式均免费只读,无需 API key,也无需注册。数据采用 CC BY 4.0 许可,使用时须注明 pdata.world;仓库代码采用 MIT 许可。
样本数据
data/ 目录保存三类批量文件的随机样本,截至 2026 年 10 月 7 日:
| 文件 | 内容 | 数量 |
|---|---|---|
| markets-open | 开放市场 | 1,000 个 |
| events-open | 开放事件 | 500 个 |
| resolved | 已结算事件 | 1,000 个 |
样本按平台尽量均分,覆盖八个来源平台。文件格式包括 json、jsonl.gz、parquet,并附有 python 与 sql 示例。
单位与注意事项
每份数据文件的首行是 manifest,声明许可、各字段含义与单位。使用 probability、volume_24hr 等字段前应先读取 manifest,避免单位误用。批量文件每晚重建并只保留最近 7 晚,长期归档请使用 Zenodo 或月度快照。Postgres 只读查询上限为 5 秒,复杂分析建议改用批量文件或样本数据。