majiayu000 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
| Command | Description |
|---|---|
/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
| Command | Description |
|---|---|
/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
| Command | Description |
|---|---|
/bf balance |
Check account balance |
/bf positions |
View 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
| Sport | ID | Example Query |
|---|---|---|
| Soccer | 1 | /bf markets champions league |
| Tennis | 2 | /bf markets wimbledon |
| Horse Racing | 7 | /bf markets ascot |
| Politics | 2378961 | /bf markets election |
| Basketball | 7522 | /bf markets nba |
Trading Notes
- Odds Format: Betfair uses decimal odds (2.0 = evens, 3.0 = 2/1)
- Minimum Stake: Usually £2/€2/$2
- Back vs Lay: Back = betting FOR, Lay = betting AGAINST
- Liability: Lay stake = liability / (odds - 1)