bobashopcashier/kalshi-cli
一个让AI代理能安全读取和交易Kalshi预测市场、不被API暗改坑到的Go命令行工具
kalshi-cli封装了预测市场平台Kalshi的交易API v2,让AI代理和脚本能通过稳定、有边界的JSON格式浏览和交易预测市场。如果Kalshi更改了响应中的必填字段或格式,该工具会立即报错UPSTREAM_SCHEMA_MISMATCH并指出具体是哪个字段出了问题,而不是悄悄传递错误数据。在包含48个用例的回归测试中,该工具检测出了全部32个人为注入的破坏性API变更,而不做校验的普通JSON解析器一个都没检测出来。
它做什么
- 封装Kalshi Trade API v2,以带版本号的JSON格式输出持仓、已实现盈亏、成交记录和K线(价格走势)数据,数字采用定点数表示
- 当Kalshi更改必填字段、类型或格式时,工具会立即整体失败并报错UPSTREAM_SCHEMA_MISMATCH,同时指出具体的JSON路径
- 交易类写操作默认被拒绝,必须经过明确的确认流程才能执行,属于'受管控'的写入策略
- 对分页和输出内容设置了数量上限,防止响应无限膨胀
- 其搜索功能因Kalshi本身不提供全文搜索,只能对已抓取的市场页面做不区分大小写的子字符串匹配,结果保持原始顺序而非按相关度排序
为什么重要
对于构建接触实时金融数据的AI代理或自动化流程的人来说,这能防范一个真实风险:API悄悄改变格式而代理却基于错误信息继续行动。它还通过字段筛选把响应体积削减了近80%,降低了把数据喂给语言模型时的上下文成本。
本仓库术语
- 模式校验(schema validation) · 检查收到的数据结构和格式是否符合约定
- 定点数(fixed-point) · 小数点位置固定的数字格式,可避免四舍五入误差
- 分页(pagination) · 把大量数据分成多页依次获取的方式
- K线(candlestick) · 按时间段显示开盘价、最高价、最低价、收盘价的价格图表数据
- 默认拒绝(deny-by-default) · 除非明确允许,否则默认拒绝请求的安全原则
仓库简介(英文)
Go command-line client for Kalshi Trade API v2 with versioned, schema-validated JSON output.
在 GitHub 打开热门仓库
- vorssaint/vorssaint-utils一个免费菜单栏应用,顶替十几款付费Mac工具
- Alishahryar1/free-claude-code一个本地代理,把编程AI助手接到49家免费或低价模型服务商,不再只能用一家付费服务
- freestylefly/awesome-gpt-image-2把532个GPT-Image2案例拆解成可复用模板的提示词工程库
- block/buzz一个让人类和AI智能体在同一空间里聊天、写代码、做审查的开源协作平台
- NousResearch/hermes-agentNous Research推出的Hermes是一款越用越聪明的AI智能体
- virgiliojr94/book-to-skill把技术类书籍PDF变成AI编程助手随时可查阅的技能包
- VoltAgent/awesome-agent-skills把上千份让AI编程助手秒变专家的操作手册集中放在一个地方
- anthropics/claude-plugins-community一个把大家做的Claude插件集中起来供安装的仓库