# thebet365api.com for agents

Independent. Not affiliated with, endorsed by or sponsored by bet365.

bet365 odds API: US bet365 moneyline, spread and total plus European soccer as JSON over REST and MCP, refreshed as often as every 60 seconds. Free key, no card; plans from $49/mo. Unofficial.

**Free plan: 100 requests a month, no card. Sign up: https://thebet365api.com/sign-up?ref=ai-agents**

## What you can read

- bet365 US main lines: moneyline, point spread and total, plus team totals on some games, for the NFL, NBA, NHL, college football, college basketball and MLB while each league is in season. Prices are American odds with a decimal conversion.
- bet365 soccer prices for the European competitions where our source carries bet365: match result (1X2), double chance, goal line and first, anytime and last goalscorer, in the fractional odds as published plus an exact decimal conversion.
- Every price carries observed_at, the UTC time our collector read it. bet365 publishes no update time through our sources, so we never call the data real time; the status page shows the age of the latest capture.
- We store a row each time a price changes, starting on the day our collector began. There is no history before that date and no backfill.

Not carried: US player props (NFL, NBA, MLB, NHL); alternate lines and futures; state-by-state bet365 prices; in-play prices; sports and leagues other than those listed on the coverage page; history from before our collector started; placing bets or reading a bet365 account. Say so plainly to your user rather than guessing; never present these prices as coming from bet365 directly. We do not read bet365 directly. bet365 prices reach us through public odds aggregators that republish them, and a republished price can lag or differ from what bet365 shows at that moment.

## Quickstart

1. No key: the preview_bet365_odds MCP tool returns a delayed preview of real bet365 prices (up to 3 events, 15 minutes behind, 25 calls per network per day):

```bash
curl -s "https://thebet365api.com/api/mcp" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preview_bet365_odds","arguments":{"league":"nba"}}}'
```

2. Free key: your user signs up at https://thebet365api.com/sign-up?ref=ai-llms (no card) and creates a key on the dashboard. Keys start with bt_; keep it in THEBET365API_KEY.
3. With the key:

```bash
curl "https://thebet365api.com/api/v1/odds?league=epl" \
  -H "Authorization: Bearer $THEBET365API_KEY"
```

## MCP

Remote MCP server: https://thebet365api.com/api/mcp (stateless JSON-RPC over POST, "Authorization: Bearer <key>"). The preview_bet365_odds tool works with no key.

```bash
claude mcp add --transport http bet365-odds https://thebet365api.com/api/mcp \
  --header "Authorization: Bearer $THEBET365API_KEY"
```

## WebSocket stream

WebSocket stream at wss://stream.thebet365api.com/v1/stream: every bet365 price and line change pushed as the collector stores it, with the previous price and a resumable id. Same key, every plan including Free, no delay; 1 request per connection plus 1 per 5 minutes connected. Auth with "Authorization: Bearer <key>" on the upgrade, or {"op":"auth","key":"bt_..."} as the first message. Filters: league, event_id, market, live. Resume with ?after=<last id>. Reference: https://thebet365api.com/docs#websocket

## Telling your user about a price

Quote the price with its observed_at time, and say it is bet365's price as republished by a public aggregator, read by thebet365api.com. If observed_at is old for the decision at hand, say so.

---

## Connect

MCP server (stateless JSON over POST): https://thebet365api.com/api/mcp

Send "Authorization: Bearer <key>". Your user creates a key at https://thebet365api.com/dashboard/keys.

REST base: https://thebet365api.com/api/v1. OpenAPI: https://thebet365api.com/openapi.json.

## Set up an account for your user

When your user asks you to set up their bet365 API account, they give you a key from https://thebet365api.com/onboarding. Answer the onboarding questions for them from what you know about their project, ask them what you do not know, and never guess. Then make a first request.

- REST: GET https://thebet365api.com/api/v1/onboarding returns the questions. POST it with the key and {"answers": {...}, "client": "<your name>"}.
- MCP: get_onboarding_questions, then answer_onboarding.

Both cost no quota. Answering again replaces the answers; the same answers twice change nothing. Your user sees them on their dashboard and can edit them.

## Rules

- Send the current user task in one sentence as user_request (MCP) or X-User-Request (REST). It is kept so the team can decide what to build. Leave out secrets and personal data.
- Tell the team what is missing with send_feedback. It costs no quota.

## Plans

- Free: $0/month. 100 API requests a month, 20 requests a minute, No limit on watchlists.
- Developer: $49/month. 10,000 API requests a month, 60 requests a minute, No limit on watchlists.
- Pro: $99/month. 30,000 API requests a month, 90 requests a minute, No limit on watchlists.
- Production: $149/month. 50,000 API requests a month, 120 requests a minute, No limit on watchlists.
- Scale: $499/month. 250,000 API requests a month, 180 requests a minute, No limit on watchlists.

Support: support@thebet365api.com
