Bet Code Conversion API

Convert a booking code to one bookmaker

Use POST /v1/convert to transform a booking code from SportyBet, Bet9ja, 1xBet, MSport, or 25 other supported bookmakers into one target bookmaker. A convert costs 2 API credits for the target, needs an X-API-Key header, and supports 24-hour Idempotency-Key replay.

POST /v1/convert
{"code": "7B9A2F", "from": "sportybet", "to": "1xng"}

from and to are the documented names. to can be a string or a list.

{
  "success": true,
  "source": {"key": "sportybet", "name": "SportyBet", "code": "7B9A2F"},
  "target": {"key": "onexbet", "name": "1xBet", "code": "R9QF0U"},
  "counts": {"original": 13, "converted": 12, "unmappable": 1},
  "odds": {"source": "24.51", "target": "23.90"},
  "partial": true,
  "verified": true,
  "fallbacks": [],
  "failures": [],
  "billing": {
    "action": "convert", "price": 2, "credits_used": 14,
    "credits_limit": 5000, "credits_reset": "2026-12-01T00:00:00Z"
  }
}

Convert one code to 2 to 6 bookmakers at once

Send 2 to 6 targets in the same POST /v1/convert call to fan out one booking code. The API fetches the source code one time, runs every target at the same time, charges 2 API credits for each target, refunds every failed target, and accepts more than 6 targets only through a job.

POST /v1/convert
{"code": "7B9A2F", "from": "sportybet",
 "to": ["1xng", "msport", "bet9ja"]}

{
  "success": true,
  "batch_id": "b_8f3c1d",
  "source": {"key": "sportybet", "name": "SportyBet", "code": "7B9A2F"},
  "results": [
    {"target": {"key": "onexbet", "name": "1xBet"},
     "success": true, "code": "R9QF0U",
     "converted": 12, "partial": false, "verified": true, "failures": []},
    {"target": {"key": "msport", "name": "MSport"},
     "success": false,
     "error": {"code": "bookmaker_unavailable", "message": "MSport did not answer."}}
  ],
  "billing": {
    "action": "convert", "price": 6, "credits_used": 14,
    "credits_limit": 5000, "credits_reset": "2026-12-01T00:00:00Z"
  }
}

• The top-level success is true when at least one code exists.
• A total failure returns 422 and puts the same results in details.
• History writes one row for each code. All rows share the batch_id.

Convert to All bookmakers and Bulk Convert 2 to 4 codes

Use POST /v1/convert/all (or POST /v1/convert with "to": "all") to convert one code to all eligible bookmakers at once using per-family concurrency lanes. Use POST /v1/convert/bulk to convert 2 to 4 source codes across all or selected bookmakers in one call (each slip automatically skips its own source bookmaker). Pass "include_card": true on either endpoint to also receive a 1080×1920 PNG share card (data:image/png;base64,...).

POST /v1/convert/all
{"code": "7B9A2F", "from": "sportybet", "include_card": false}

POST /v1/convert/bulk
{"codes": [
  {"code": "7B9A2F", "from": "sportybet"},
  {"code": "B9JA12", "from": "bet9ja"}
 ],
 "to": ["1xng", "msport", "sportybet"]}

What does a convert cost and what are the limits

A Manage Bet Codes convert costs 2 API credits per target (1 target costs 2 credits, 3 targets cost 6 credits); failed targets are refunded automatically. One call accepts 1 to 6 targets, and more than 6 targets returns 422 too_many_targets, so use a POST /v1/jobs async job (up to 15 targets, 20 codes, 100 pairs). Each target has a 65-second budget inside an 80-second batch call.

A batch of 3 converts costs 6 credits. A job of 15 converts costs 30 credits.