# Manage Bet Codes API

> Public API v1 for bet code conversion, slip views, split, merge, live tracking, and booking.

Base URL: https://api.managebetcodes.app/v1
Auth: X-API-Key: mbc_live_...
Docs: https://managebetcodes.app/docs
OpenAPI: https://api.managebetcodes.app/v1/openapi.json
Capabilities: https://api.managebetcodes.app/v1/capabilities
Errors: https://api.managebetcodes.app/v1/errors
Markets: https://api.managebetcodes.app/v1/markets
Bookmakers: https://api.managebetcodes.app/v1/bookmakers
Dashboard: https://managebetcodes.app/dashboard/api
Fact sheet: https://managebetcodes.app/facts

## Product

- [Product fact sheet](https://managebetcodes.app/facts): Bookmakers, prices in naira, API routes, MCP server, limits, accounts, and contact. Last updated 11 November 2026.

## Docs

- [Quickstart](https://managebetcodes.app/docs/quickstart): Create a key and make the first call.
- [Authentication](https://managebetcodes.app/docs/authentication): Keys, the X-API-Key header, rotation, and revocation.
- [Bet Code Conversion API](https://managebetcodes.app/docs/convert): Convert booking codes between SportyBet, Bet9ja, 1xBet, and 12+ bookmakers.
- [Jobs](https://managebetcodes.app/docs/jobs): Run long or bulk work in the background.
- [Bet Slip View & Data API](https://managebetcodes.app/docs/view): Read bet slip selections, odds, and match status as JSON across SportyBet, Bet9ja, and 1xBet.
- [Image](https://managebetcodes.app/docs/image): Download a slip as a PNG.
- [Bet Code Splitter API](https://managebetcodes.app/docs/split): Split one booking code into 2 to 20 codes on the same bookmaker using Equal, By batches, Target odds, or Custom game counts.
- [Bet Slip Merge API](https://managebetcodes.app/docs/merge): Merge 2 to 30 booking codes into one code across SportyBet, Bet9ja, and 1xBet.
- [Live Bet Slip Tracking API](https://managebetcodes.app/docs/track): Follow live match status with polling and webhooks for SportyBet, Football.com, and Betway.
- [History](https://managebetcodes.app/docs/history): List your conversions.
- [Bet Slip Booking API](https://managebetcodes.app/docs/book): Create new booking codes programmatically from selected matches.
- [Search](https://managebetcodes.app/docs/search): Find events and markets.
- [Resolve](https://managebetcodes.app/docs/resolve): Resolve picks into a short-lived plan.
- [Books](https://managebetcodes.app/docs/books): List your book rows.
- [Capabilities](https://managebetcodes.app/docs/capabilities): Read the machine manifest.
- [Errors](https://managebetcodes.app/docs/errors): Read the error envelope and every error code.
- [Limits](https://managebetcodes.app/docs/limits): Compare plans, rate limits, and the bookmaker budget.
- [Plans](https://managebetcodes.app/docs/plans): Read API plans and the billing lifecycle.
- [Packs](https://managebetcodes.app/docs/packs): Buy API credit packs.
- [Charge order](https://managebetcodes.app/docs/charge-order): Choose which credit pool pays.
- [Changelog](https://managebetcodes.app/docs/changelog): Read the version policy.

## SDKs & MCP Server

- [Bet Code Converter MCP Server](https://managebetcodes.app/mcp): Interactive setup for Claude Desktop, Cursor, Windsurf, OpenCode, and remote Streamable HTTP (`POST /v1/mcp`).
- [Python SDK for Bet Code APIs](https://managebetcodes.app/docs/sdk/python): package managebetcodes on PyPI. Python 3.9+ for SportyBet, Bet9ja, and 1xBet.
- [TypeScript & Node.js SDK](https://managebetcodes.app/docs/sdk/typescript): package @managebetcodes/sdk on npm. Node 18+.
- [@managebetcodes/mcp & JSON-RPC Reference](https://managebetcodes.app/docs/sdk/mcp): package @managebetcodes/mcp on npm (stdio) and remote Streamable HTTP at https://api.managebetcodes.app/v1/mcp.

## Notes

- Every request carries X-API-Key.
- Every POST accepts Idempotency-Key. A replay is valid for 24 hours.
- Every response carries X-Request-ID and X-Robots-Tag: noindex.
- Search query syntax: pass one team ("Real Madrid", "Man Utd") for a single-team search, or separate two teams with "vs", "v", or "-" ("Arsenal vs Chelsea", "Arsenal v Chelsea", "Arsenal - Chelsea") for a head-to-head search. Team aliases and club affixes (FC, AFC, CF, SC) are normalized automatically.
- Prices: convert 2 credits for each target. Text view 1. Image view 2. Split 2 plus 1 for each extra output. Merge 2 plus 1 for each extra code. Track start 1. Book 2 for each code.
- API credits are not AI credits. The API never spends AI credits.