CloddsBot市场索引API：Kalshi/Manifold实时行情语义检索实战指南-开发者社区

CloddsBot市场索引API：Kalshi/Manifold实时行情语义检索实战指南

【免费下载链接】CloddsBotOpen Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes instantly, manages risk while you sleep. Agent commerce protocol for machine-to-machine payments. Self-hosted. Built on Claude.项目地址: https://gitcode.com/GitHub_Trending/cl/CloddsBot

CloddsBot 是一款开源 AI 交易代理，可自主覆盖 Polymarket、Kalshi、Manifold、Metaculus 等 1000+ 预测市场。它内置的市场索引（Market Index）API能自动同步 Kalshi/Manifold 等平台的实时行情元数据——问题文本、状态、24h 交易量、流动性、未平仓合约等，并支持一句话语义检索。本文带你从零理解这三个 HTTP 端点（/market-index/search、/market-index/stats、/market-index/sync），并展示如何配置自动同步，让市场数据"随睡随有"。

什么是 CloddsBot 的市场索引？

简单来说：CloddsBot 会周期性地把各平台的"市场目录"抓下来，存入本地 SQLite，并为每个市场生成嵌入向量（embedding），从而支持语义搜索——比如输入 "Fed 降息" 就能匹配到 Kalshi 上 "Fed cuts rates in January" 这类市场，即使措辞不完全一致。

核心实现位于 src/market-index/index.ts，它定义了三大能力：

能力	方法	说明
同步	`sync()`	从平台 API 拉取市场，按内容哈希增量更新
检索	`search()`	向量相似度 + 关键词加权，返回排序结果
统计	`stats()`	查看本地索引规模与最近同步情况

支持的平台：polymarket、kalshi、manifold、metaculus（src/market-index/index.ts）。

一键调用：三个核心 API 端点

所有端点都暴露在网关 HTTP 服务中（路由注册见 src/gateway/server.ts），完整字段文档可参考 docs/API.md。

GET /market-index/search：语义检索行情

最常用的端点。用q传入自然语言，返回按相关性排序的市场列表。

curl "http://localhost:PORT/market-index/search?q=Will%20Trump%20win&platform=kalshi&limit=5"

常用查询参数：

q（必填）：搜索文本
platform：限定平台，如kalshi、manifold
limit/maxCandidates：结果数 / 候选池大小
minScore：最低相似度阈值
platformWeights：JSON 字符串，为不同平台设置权重

返回结构中每个结果包含score与完整市场快照：question、status、volume24h、liquidity、openInterest、url等（src/gateway/index.ts）。

💡 小技巧：platformWeights可传{"kalshi":2,"manifold":1}，优先返回 Kalshi 结果。

GET /market-index/stats：查看索引健康度

curl "http://localhost:PORT/market-index/stats?platforms=kalshi,manifold"

返回各平台已索引市场数、上次同步时间、同步耗时与清理数量，适合写进自己的监控脚本。

POST /market-index/sync：手动触发同步

curl -X POST http://localhost:PORT/market-index/sync \ -H "Content-Type: application/json" \ -d '{"platforms":["kalshi","manifold"],"limitPerPlatform":300,"status":"open"}'

Body 支持丰富的过滤条件（docs/API.md）：

status：open/closed/settled/all
excludeSports：默认排除体育类市场
minVolume24h/minLiquidity/minOpenInterest：只索引"有量"的市场
prune+staleAfterMs：清理过期数据

自动同步：行情"睡觉也新鲜"

网关启动时会读取配置中的marketIndex段（类型定义见 src/types.ts），默认每 6 小时自动全量增量同步一次，并清理 7 天未更新的市场（src/gateway/index.ts）：

配置项	默认值	含义
`syncIntervalMs`	6h	同步间隔
`staleAfterMs`	7d	过期市场清理阈值
`limitPerPlatform`	300	每平台最多同步条数
`status`	`open`	只抓进行中市场
`excludeSports`	`true`	排除体育
`platformWeights`	无	检索时的平台加权

同步采用内容哈希增量更新：内容没变的市场直接跳过，避免重复写入，效率很高。

本地验证：CLI 与测试用例

不想调 HTTP？也可以直接用 CLI：

clodds market-index stats # 查看索引统计 clodds market-index sync # 手动触发同步

想确认 Kalshi / Manifold 上游接口真的能打通？仓库自带活接口集成测试，可直接参考断言方式：

tests/integration/market-index-live-kalshi.test.ts —— 真实调用 Kalshi API 并验证返回结构
tests/integration/market-index-live-manifold.test.ts —— Manifold 平台同理
tests/integration/market-index-endpoints.test.ts —— 三个 HTTP 端点的行为测试

总结

CloddsBot 市场索引 API 把"多平台预测市场行情聚合"这件事做成了三个简单端点：search 语义检索、stats 看状态、sync 手动刷新。配合默认 6 小时自动同步与内容哈希去重，你无需自己维护爬虫——只要marketIndex.enabled打开，Kalshi、Manifold、Polymarket 的实时市场快照就随时可供你的机器人或脚本调用。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考