pdata-client:跨平台预测市场数据客户端与样本

医疗健康
0 下载
4 浏览
2026-10-07

数据集简介

关于 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 秒,复杂分析建议改用批量文件或样本数据。

基本信息

记录数量样本数据:1,000 个开放市场、500 个开放事件、1,000 个已结算事件(按平台尽量均分);全量批量文件每晚重建,行数与校验和见 index.json,保留最近 7 晚
文件大小未知
文件格式JSON, JSONL.GZ, Parquet, Python, SQL
数据来源pdata.world
许可协议CC BY 4.0
代码许可MIT
DOI10.5281/zenodo.23211610
覆盖平台8 个
更新频率每 10–60 分钟轮询;批量文件每晚重建
数据落地页https://github.com/noskillcoding/pdata-client
发布日期2026-10-07
预测市场跨平台数据Python客户端概率数据开源数据

上架信息

数据集市运营
平台统一选品上架,经质量审核后公开
0 次下载

价格

免费