赛马投注代理

一个用于澳大利亚赛马和灰狗赛事的自主投注代理,具备市场分析、风险管理和实时交易执行功能。

  • by BeanBagData
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BeanBagData/betfair-mcp

使用说明

🏇 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. 利润阈值:默认情况下,它会寻找利润率≥1.5(铺设价格≤1.67),除非模型边缘非常强。
  2. 模型确认:它更喜欢躺在 Kash/Iggy模型 同意这匹马被高估了。
  3. 流动性检查:它检查 Market Spread 和 Available Volume 以确保您的赌注匹配。
  4. 交互模式:对于大型自动化会议,它将解释计划(场地、预算、策略),并在开始前要求您确认。

使用克劳德桌面(MCP)

该项目包括一个模型上下文协议(MCP)服务器,允许您直接在内部使用这些工具 克劳德桌面版.

  1. 将服务器配置添加到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"]
    }
  }
}
  1. 重新启动克劳德桌面。您现在将看到🔌 图标,克劳德可以使用你的Betfair工具!

免责声明

⚠️ 赌博涉及重大的财务风险。

该软件是一个展示自主代理功能的研究项目。这不是财务建议。

  • 永远不要赌你输不起的钱。
  • 该软件可能包含可能导致意外财务损失的错误。
  • 当代理在自动模式下运行时,始终对其进行监控。

负责任的赌博: