mcpField
B
betfair

betfair

github.com/alsk1992Other3.0k49 installsUpdated 7w ago
Repository

About betfair

betfair provides command-based access to Betfair Exchange market data and trading. It covers market searches, prices, orders, and account information, including back and lay orders.

Key features

  1. 01Search markets and inspect market details
  2. 02View prices, volumes, and order books
  3. 03Place back and lay orders
  4. 04Cancel and list open orders
  5. 05Check balances and positions
  6. 06Real-time price updates via WebSocket

Use cases

  1. 01Finding sports markets by query
  2. 02Checking prices and available volumes
  3. 03Placing or cancelling exchange orders

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/alsk1992/cloddsbot --skill betfair

After installing, type/betfairin Claude Code to confirm it loaded.

Bundled filesindex.ts

Details

From the project README

Betfair Exchange

Full integration with Betfair Exchange, the world's largest sports betting exchange. Trade sports markets using back/lay orders.

Quick Start

# Set credentials
export BETFAIR_APP_KEY="your-app-key"
export BETFAIR_SESSION_TOKEN="your-session-token"

# Search markets
/bf markets football

# Get market prices
/bf prices 1.234567890

# Place back order (bet FOR outcome)
/bf back 1.234567890 12345678 2.5 10

# Place lay order (bet AGAINST outcome)
/bf lay 1.234567890 12345678 2.5 10

Commands

Market Data
CommandDescription
/bf markets [query]Search markets
/bf market <id>Get market details
/bf prices <marketId>Current prices and volumes
/bf book <marketId> <selectionId>Show orderbook
Trading
CommandDescription
/bf back <marketId> <selectionId> <odds> <stake>Place back order
/bf lay <marketId> <selectionId> <odds> <stake>Place lay order
/bf cancel <marketId> <betId>Cancel order
/bf cancelall [marketId]Cancel all orders
/bf orders [marketId]List open orders

Examples:

/bf back 1.234 5678 2.0 10    # Back at 2.0 odds, £10 stake
/bf lay 1.234 5678 2.1 10     # Lay at 2.1 odds, £10 liability
/bf cancel 1.234 abc123       # Cancel specific order
Account
CommandDescription
/bf balanceCheck account balance
/bf positionsView open positions

Configuration

# Required
export BETFAIR_APP_KEY="your-app-key"

# Either session token or username/password
export BETFAIR_SESSION_TOKEN="your-session-token"

# Or login credentials
export BETFAIR_USERNAME="your-username"
export BETFAIR_PASSWORD="your-password"

Features

  • Back/Lay Trading - Trade both sides of markets
  • Live Streaming - Real-time price updates via WebSocket
  • Sports Coverage - Football, tennis, horse racing, politics, and more
  • Low Fees - Exchange model with 2-5% commission
  • Deep Liquidity - World's largest betting exchange

Event Types

SportIDExample Query
Soccer1/bf markets champions league
Tennis2/bf markets wimbledon
Horse Racing7/bf markets ascot
Politics2378961/bf markets election
Basketball7522/bf markets nba

Trading Notes

  1. Odds Format: Betfair uses decimal odds (2.0 = evens, 3.0 = 2/1)
  2. Minimum Stake: Usually £2/€2/$2
  3. Back vs Lay: Back = betting FOR, Lay = betting AGAINST
  4. Liability: Lay stake = liability / (odds - 1)

Resources

Comments

Markdown supported