用途:从 Polymarket 和 Kalshi 获取预测市场的赔率、价格与市场数据,回答“某事件概率是多少”“当前赔率如何”等问题,也可用于市场情绪研究、选举或事件概率查询。
主要能力:通过 Dome API 聚合两家预测市场的数据,支持获取 Polymarket 市场列表、按关键词搜索市场、获取 Kalshi 市场、Polymarket 交易活动、市场订单,以及体育类市场(含具体项目,如 nba、nfl、mlb、nhl、soccer、tennis)。市场响应包含标题、market_slug、condition_id、起止时间、标签、多周期交易量、side_a/side_b、winning_side、图片等;活动响应包含交易方向、份额、价格、时间戳、用户钱包地址和交易哈希。价格以 0 到 1 的小数表示概率,例如 0.65 表示 65%,“Yes”价格即市场认为事件发生的概率,交易量越高通常代表流动性越强。
使用方式:先从 ~/.gooseworks/credentials.json 读取凭据并设置环境变量:export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])"),以及 export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")。若凭据文件不存在,提示用户运行 npx gooseworks login。所有端点使用 Bearer 认证:-H "Authorization: Bearer $GOOSEWORKS_API_KEY"。随后以 POST 方式调用代理接口,请求体指定 api 为 dome 及对应 path,例如查询开放市场:curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run -H "Authorization: Bearer $GOOSEWORKS_API_KEY" -H "Content-Type: application/json" -d '{"api":"dome","path":"/polymarket/markets","query":{"status":"open"}}'。搜索市场可传 query 中的 search 字段。
限制与注意事项:搜索时需提供 status 参数(open 或 closed)。错误处理包括 400(缺少 status)、401(API 密钥无效)、429(触发限流,需等待重试);返回空 markets 数组表示无匹配市场。活动端点返回全局近期交易,无需筛选。Polymarket 偏重政治与世界事件,Kalshi 偏重金融与天气。具体收费、价格或配额信息暂未提供。