{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"d4e1d08c-51e1-4d92-a564-5925001f6fed","name":"Betpaddi API","description":"# Betpaddi API v1\n\nBuild bet code conversion and prediction solutions easily and quickly with our APIs. Connect your customers to high-quality sports services.\n\n---\n\n## Overview\n\nWelcome to the Betpaddi API, your gateway to integrating powerful sports betting utilities into your platform, app, or service.  \nOur API allows seamless access to core functionalities of the Betpaddi ecosystem, designed to serve sports bettors, tipsters, affiliate platforms, fantasy sports apps, and developers building around football data and prediction logic.\n\n### Available APIs\n\n**Bet Code Conversion**  \nConvert bet booking codes across top African bookmakers.\n\n**AI Football Predictions**  \nMathematically calculated predictions (1X2, Over/Under, BTTS, and more).\n\n---\n\n## Getting Started\n\nYou need to be a registered user with **developer access** on [Betpaddi](https://betpaddi.com).\n\n1. Log in to your [Betpaddi Dashboard](https://betpaddi.com/app/api)\n    \n2. Navigate to the **Developer** page from the sidebar\n    \n3. Click **Generate API Key** to receive your unique key\n    \n4. Add the API key to the `X-API-Key` header of every request\n    \n\n### Base URL\n\n```\nhttps://betpaddi.com/api/v1\n\n ```\n\n### Authentication\n\nAll requests must include your API key in the `X-API-Key` header:\n\n```\nX-API-Key: YOUR_API_KEY\n\n ```\n\n### Credit System\n\n| Endpoint | Cost |\n| --- | --- |\n| GET /conversion/rate | Free |\n| GET /conversion/bookies | Free |\n| POST /conversion/convert-code | 1 Credit |\n| GET /predictions | 10 Credits |\n\n> Credits are deducted from your wallet balance. Top up your credits from the [Credits page](https://betpaddi.com/app/credits). \n  \n\n### Authentication Errors\n\n``` json\n// Missing API Key\n{\n    \"status\": \"error\",\n    \"message\": \"API Key required in X-API-Key header.\"\n}\n// Invalid API Key\n{\n    \"status\": \"error\",\n    \"message\": \"Invalid API Key.\"\n}\n// No developer permissions\n{\n    \"status\": \"error\",\n    \"message\": \"This API Key does not have developer permissions.\"\n}\n\n ```\n\n---\n\n## Support\n\nIf you are experiencing any issues while integrating, contact us via [support@betpaddi.com](https://mailto:support@betpaddi.com).","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"17112744","team":3212269,"collectionId":"d4e1d08c-51e1-4d92-a564-5925001f6fed","publishedId":"2sB2qZFNfu","public":true,"publicUrl":"https://documenter-api.postman.tech/view/17112744/2sB2qZFNfu","privateUrl":"https://go.postman.co/documentation/17112744-d4e1d08c-51e1-4d92-a564-5925001f6fed","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"01145c"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Betpaddi's API enables seamless conversion of bet codes across major bookies and offers access to AI-driven football predictions for smarter betting."},{"name":"title","value":"Bet Code Converter API"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/a29fee9a-92a3-49b1-b45a-58491b3ff511/ZmF2aWNvbi5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"01145c"}},{"name":"light","logo":"https://content.pstmn.io/a29fee9a-92a3-49b1-b45a-58491b3ff511/ZmF2aWNvbi5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"01145c"}}]}},"version":"8.10.1","publishDate":"2025-05-21T13:01:21.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Bet Code Converter API","description":"Betpaddi's API enables seamless conversion of bet codes across major bookies and offers access to AI-driven football predictions for smarter betting."},"logos":{"logoLight":"https://content.pstmn.io/a29fee9a-92a3-49b1-b45a-58491b3ff511/ZmF2aWNvbi5wbmc=","logoDark":"https://content.pstmn.io/a29fee9a-92a3-49b1-b45a-58491b3ff511/ZmF2aWNvbi5wbmc="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/0ff64c29e34807e3af129fb7200b642fb04b0c380d52499bc0887e1725a63f21","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sB2qZFNfu"}