使用说明
🏇 Betfair代理商
一个复杂的、自主的澳大利亚赛马和灰狗比赛博彩代理,由 双子座2.5闪光灯, 花卉,以及 必发API.
这个代理人不仅下注,还充当一个完整的 交易台。它组织专门的子代理扫描场地,分析市场流动性,检查外部模型评级(Kash/Iggy),使用Kelly质押管理风险,并使用实时流数据执行交易。
🚀 主要特点
🧠 智能编排
- 多代理架构: 将“在Doomben赚钱”分解为由专业人员处理的具体任务:
- 场地分析员: 扫描每场比赛,计算优势,并为机会打分。
- 风险经理: 分配资金,设置止损,并执行断路器。
- 执行人: 启动背景流(Flumine)以在最佳时间下注。
- 记者: 跟踪实时损益并总结绩效。
📊 高级市场分析
- 外部模型集成: 自动检查 喀什 (纯种马)和 伊基 (灰狗)模型评级以寻找价值。
- 金钱的重量(WOM): 分析市场压力(回撤量与回撤量)以确认走势。
- 蒸汽/漂移检测: 关注实时价格,以捕捉漂流者(良好的目标)并避免轮船。
- 种族背景: 将障碍物、距离和赛道条件等因素纳入其置信度得分。
⚡ 专业执行
- 流媒体(Flumine): 使用Betfair Exchange Stream API进行毫秒延迟价格监控。
- 智能定时: 在流动性最高的“最优”窗口(跳跃前2-10分钟)下注。
- Kelly Staking: 基于边缘和资金的数学赌注大小,具有可配置的风险限额。
🛡️ 风险管理
- 断路器: 每日止损限额(例如,下跌20%时止损)。
- 暴露上限: 在一场比赛中,风险永远不会超过资金的X%。
- 实时曝光跟踪: 在下新赌注之前检查当前的市场负债。
快速开始
1.先决条件
- Python 3.10+
- 拥有API访问权限的Betfair帐户
- Google Gemini API密钥
2.安装依赖项
pip安装-r要求.txt
### 3. Configure Credentials
**Create `credentials.json`** in the project folder:
```json
{
"username": "your_betfair_username",
"password": "your_betfair_password",
"app_key": "your_betfair_app_key"
}
获取Betfair API应用程序密钥: Betfair API访问
创建 .env 在项目文件夹中:
GEMINI_API_KEY=your_gemini_api_key_here
获取Gemini API密钥: 谷歌AI工作室
4.运行代理
python main.py
使用示例
跑步后,自然地与经纪人交谈。它理解复杂的指令。
简单命令:
You: "Lay Winx for $10"
You: "Check my balance"
You: "Show me my P&L for the last 7 days"
战略请求(编排):
You: "What races are at Doomben today?"
You: "Make money at Flemington today. Use a $500 bankroll."
You: "Scan the next 3 races at Randwick. Any good lays?"
市场情报:
You: "What does the Kash model say about Race 4 at Sandown?"
You: "Is there any steam on the favourite in the next race?"
You: "Analyse market 1.22283838. Is it a good time to bet?"
项目结构
betfair-mcp/
├── main.py # 🚀 Entry point (CLI chat interface)
├── agent.py # 🤖 Main Gemini Agent & Tool Definitions
├── sub_agents.py # 🕵️♀️ Specialized Agents (Analyst, Risk, Executor)
├── flumine_engine.py # ⚡ Streaming Execution Engine
├── market_analyser.py # 📉 Quant analysis (WOM, Spread, Steam)
├── staking_engine.py # 💰 Kelly Criterion & Simulation
├── external_ratings.py # 📡 Kash/Iggy Model Data Fetcher
├── betfair_client.py # 🔌 Betfair API Client
├── betting_memory.py # 🧠 Long-term strategy learning & history
├── shared_cache.py # ⚡ High-performance API caching
├── mcp_server.py # 🔧 MCP Server for Claude Desktop
├── requirements.txt # 📦 Dependencies
├── credentials.json # 🔐 Credentials (user provided)
└── bet_log.json # 📝 Audit log of all bets placed
博彩逻辑与安全
代理是用 “安全第一” 哲学:
- 利润阈值:默认情况下,它会寻找利润率≥1.5(铺设价格≤1.67),除非模型边缘非常强。
- 模型确认:它更喜欢躺在 Kash/Iggy模型 同意这匹马被高估了。
- 流动性检查:它检查
Market Spread和Available Volume以确保您的赌注匹配。 - 交互模式:对于大型自动化会议,它将解释计划(场地、预算、策略),并在开始前要求您确认。
使用克劳德桌面(MCP)
该项目包括一个模型上下文协议(MCP)服务器,允许您直接在内部使用这些工具 克劳德桌面版.
- 将服务器配置添加到Claude Desktop配置文件中:
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - 雨衣:
~/Library/Application Support/Claude/claude_desktop_config.json
- 窗户:
{
"mcpServers": {
"betfair": {
"command": "python",
"args": ["C:/path/to/betfair-mcp/mcp_server.py"]
}
}
}
- 重新启动克劳德桌面。您现在将看到🔌 图标,克劳德可以使用你的Betfair工具!
免责声明
⚠️ 赌博涉及重大的财务风险。
该软件是一个展示自主代理功能的研究项目。这不是财务建议。
- 永远不要赌你输不起的钱。
- 该软件可能包含可能导致意外财务损失的错误。
- 当代理在自动模式下运行时,始终对其进行监控。
负责任的赌博:
- Betfair负责任博彩
- 赌博求助热线(澳大利亚): 1800 858 858