关于 KellyIQ
KellyIQ 是面向脚本、电子表格、模型和 AI 助手用户的托管投注组合计算服务。它会扣除庄家水位,并按分数 Kelly 和风险敞口限制为选定的投注组合分配金额。
主要功能
- 01整张投注单联合计算金额
- 02扣除庄家水位
- 03单注与总风险敞口限制
- 04Python 和 JavaScript 示例
- 05Excel 电子表格集成
适用场景
- 01根据模型概率计算投注单
- 02通过 CSV 导入投注并导出金额
- 03让 AI 助手计算投注单
MCP 相关
KellyIQ 在 https://api.kellyiq.com/mcp 提供托管 MCP 服务,将投注组合计算作为 AI 助手可用的工具。Claude 通过登录连接,编码工具使用 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.kellyiq.com/mcpclaude mcp add --transport http com-kellyiq-kellyiq https://api.kellyiq.com/mcp{"mcpServers":{"com-kellyiq-kellyiq":{"type":"http","url":"https://api.kellyiq.com/mcp"}}}在 Cursor 中打开{"servers":{"com-kellyiq-kellyiq":{"type":"http","url":"https://api.kellyiq.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-kellyiq-kellyiq":{"type":"http","url":"https://api.kellyiq.com/mcp"}}}{"mcpServers":{"com-kellyiq-kellyiq":{"serverUrl":"https://api.kellyiq.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://api.kellyiq.com/mcp需要授权工具
详细介绍
KellyIQ 示例
KellyIQ API 的实用示例:通过自己的脚本、模型、电子表格和 AI 助手,将整场体育博彩赛事作为一个投资组合来计算投注金额。
你需要提交资金总额、选定的投注以及对每项投注的判断。KellyIQ 会从每个赔率中扣除博彩公司利润,应用你的判断,并在单项投注限额和总风险敞口限制下,将所有投注作为一个整体计算投注金额,返回每项投注的金额。
获取密钥
在 KellyIQ 应用的 Settings → API 中创建 API 密钥。所有套餐都包含 API 访问权限,包括 Free 套餐,每个套餐都有自己的每日额度。然后:
export KELLYIQ_API_KEY="kiqa_..."
示例方案
每个示例方案都是一个完整脚本,提供 Python(requests)和 JavaScript(Node 18+,无需安装软件包)版本。
| 示例方案 | 展示内容 |
|---|---|
first-optimize | 计算包含三项投注的赛事投注金额,并查看结果的各个部分 |
slate-from-csv | 将赛事投注数据保存在电子表格中:输入 CSV,输出包含投注金额的 CSV(slate.csv) |
reproducible-results | 使用返回的种子再次获得完全相同的结果 |
handling-limits | 遇到速率限制或服务器繁忙时,等待后重试 |
cd recipes
python first-optimize.py # or: node first-optimize.mjs
每个示例方案都附有文档中的操作指南:示例方案。
Python 软件包
pip install kellyiq(kellyiq-python):使用相同的 API,并针对每种错误提供特定异常;服务器繁忙时会自动重试。
| 示例 | 展示内容 |
|---|---|
python/size-a-slate.ipynb | 笔记本:以表格形式展示投注金额、用于计算的概率,以及不同 Kelly 比例下的风险 |
python/slate_from_csv.py | 输入 CSV,输出包含投注金额的 CSV,并处理每种错误(slate.csv) |
python/size_from_model.py | 输入模型的概率,并将计算出的投注金额合并回 DataFrame(model_output.csv);需要 pandas |
python/nba_home_teams.py | 使用 DraftKings 赔率计算一场真实的 NBA 赛事(2026 年 10 月 30 日),并假设所有主队的优势程度相同,均为 Moderate Edge(nba_2026-10-30.csv);需要 pandas |
指南:Python SDK。
Excel
spreadsheets/kellyiq-slate.xlsx:输入资金总额和投注,按 Ctrl+Alt+F5,即可获取每项投注的金额及赛事摘要。无需宏,API 密钥保存在你电脑上的文件中,不会存入工作簿。适用于 Windows 版 Excel。设置说明:spreadsheets/。
基准测试
benchmarks/slate-sizing:使用 cap-then-scale、精确约束最优解和 KellyIQ 计算三场 NBA 赛事的投注金额,并按精确预期对数增长评分。其中包含赛事数据、评分脚本和每笔投注金额,可供重新运行。
AI 助手(MCP)
KellyIQ 在 https://api.kellyiq.com/mcp 上运行托管 MCP 服务,因此你的助手可以将赛事投注金额计算作为一项工具。Claude 通过登录连接;编码工具使用 API 密钥,mcp/ 中提供了可直接使用的配置:
| 助手 | 设置 |
|---|---|
| Claude(网页、桌面、移动端) | 依次选择 Settings、Connectors、Add custom connector,粘贴 URL,然后选择 Connect 并登录 |
| Claude Code | mcp/claude-code.md |
| Cursor | mcp/cursor.json |
| VS Code(GitHub Copilot) | mcp/vscode.json |
| Gemini CLI | mcp/gemini-cli.md |
完整指南:AI 助手(MCP)。
技能
skills/analyze-my-slate 会教助手如何在一条消息中收集你的
赛事列表,在使用优化功能前征求确认,并说明相关利害与风险。
Claude 和 Claude Code 的安装步骤:skills/。
文档与支持
- 快速入门、API 参考、OpenAPI 规范
- [email protected](请附上任何错误中的
requestId)
请勿将密钥放入你提交或分享的代码中;此处的所有示例都会从环境中读取密钥。
KellyIQ 会为你选择的投注计算投注额;它不会替你选择投注,也不会预测结果。结果是计算结果,并非投注建议。仅限年满 21 岁者,且须符合当地法律规定。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。