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)
Resources
-
Betfair Exchange
-
Betfair API Documentation