{
  "aid": "cloudbet.com:cloudbet-2.0",
  "name": "Cloudbet Feed API",
  "type": "Index",
  "description": "The [Cloudbet](https://www.cloudbet.com/en/sports?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/) Feed API uses a long-lived API Key to allow secure access. The `API Key` used follows the JWT authentication standard. You can use these Odds API endpoints to obtain the latest market odds information from Cloudbet.\n\nThis API returns JSON or binary protobuf responses. For JSON responses, send the header `Content-Type: application/json`. For binary protobuf responses, send the header `Content-Type: application/x-protobuf`\n\n## Authentication with API Key\n\n### Trading API\n1. The Trading API (aka Betting API) is meant for developers who want to place bets and allows you to perform sports betting programatically. You can obtain the Cloudbet Trading `API Key` by logging into your Cloudbet Player account and navigating to the [\"My account -> API\" section](https://www.cloudbet.com/en/player/api?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/). For further details about how to use the Trading API, please refer to the [Trading API Documentation](https://www.cloudbet.com/api/?urls.primaryName=Trading)\n\n\n### Affiliate API\n1. The Affiliate API is primarily meant if you want to consume Cloudbet odds without needing to place bets programatically. You can obtain the Cloudbet Affiliate `API Key` by logging into your Cloudbet Affiliate account and then visiting the [Affiliate API Token](https://affiliates.cloudbet.com/affiliate_api_token?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/) page. Please note that there are 2 tokens on this page. Make sure to generate the token in the `API Key` section. Also, please take note of the `Expires at` timestamp mentioned in this section which is of a reasonably long duration. Your `API Key` will only be valid until this timestamp and you will have to create a new `API Key` again from the [Affiliate API Token](https://affiliates.cloudbet.com/affiliate_api_token?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/) page before your current token expires to avoid your API calls from being rejected in the future.\n\n2. Using this Cloudbet Affiliate `API Key` you can then go back to https://www.cloudbet.com/api/ to test the Feed API endpoints as per the next section.\n\n3. If you authenticate with the Cloudbet Affiliate `API Key`, then the Feed API responses may be cached and up to 1 minute behind the latest updates. This is in contrast to using the Cloudbet Trading `API Key`, which gives you real-time updates.\n\n## Testing the Feed API\n\n1. Our Feed API expects the `API Key` from the previous section to be included in all API requests to the server in an HTTP header that looks like the following:\n\n`X-API-Key: <API Key>`\n\nYou must replace `<API Key>` with your own `API Key` as obtained in the previous section.\n\nExample with sample Trading `API Key`. Note that this is a standard JWT token.\n\n```\nX-API-Key: eyJhbGciOiJSUzI1NiIsImtpZCI6ImxPVGE3LXVQLVd2QUk1VjhfOHhiYWxjZWlIUmM1OHd6Wi02c21CWGE0Z2MiLCJ0eXAiOiJKV1QifQ.eyJhY2Nlc3NfdGllciI6InRyYWRpbmciLCJleHAiOjE5MzMyMzk2MjgsImlhdCI6MTYxNzg3OTYyOCwiaXNzIjoic3BvcnRzLXBsYXllcnMiLCJqdGkiOiJmZmExZjQ5MC00MzY4LTRhMjEtOGQxYy00NzFlM2FkZTAyYjYiLCJzdWIiOiJiZjA2YjFhZi0zZjM1LTQ2NWUtYTQyZC01Mjc2YTY1ODdmNTIiLCJ0ZW5hbnQiOiJjbG91ZGJldCIsInVzZXJfdXVpZCI6ImJmMDZiMWFmLTNmMzUtNDY1ZS1hNDJkLTUyNzZhNjU4N2Y1MiIsInV1aWQiOiJiZjA2YjFhZi0zZjM1LTQ2NWUtYTQyZC01Mjc2YTY1ODdmNTIifQ.LEwR9AOQ5FGhAKZPGjQ7dl1-0YYUsXbU1fNb17rhUqr_hh7SQipAOv9AlnO8vdExv0bHKrX0zX3_rAnpKdyo5Z6yVVkd-ovpvoTvoiP6gP8yoQqRnrqZKFjHtxHT1wsvqYiBhM52gWzWH77_9ccw5nh78yaxsd2PbZ9meYnqZY_M9x9HGyEU6xFaM1AZ6NaDlGp1iEgqm3atv88vJC75k9H-8Krlh06IwaJxkMnNkrq2cS-rGPDv6tK4jMYpfc7rhXj9ffOr9YOMLQ-fpv7y01hwZD94oUTVoHbAFjBYgMwkh9CdQFbLKZyV0Owb4rFM5BY-4kfKwQlvP9E0TdW3Hw\n```\n\n2. After authorization, click on any of the endpoints at https://www.cloudbet.com/api/ (e.g. `/sports`). Click on the `Authorize` button on the top right corner of the page, then enter `<API Key>`. This will authorize you to access our Feed API endpoints from within the OpenAPI GUI itself. Then click on `Try it out` and `Execute`. You will be able to see the API response on this page itself.\n\n## Samples and Supporting Documentation\nWe provide additional supporting documentation in our [Cloudbet/docs Github repo](https://github.com/Cloudbet/docs)\n\n### cURL Samples\nHere are some Feed API cURL samples illustrating the recommended way to ingest odds in bulk from the Cloudbet API.\nSpecifically, these samples demonstrate how to request specific Soccer and Baseball markets for the English Premier League (EPL) and Major League Baseball (MLB) competitions respectively.\n\n1. Fetch Match Odds, Asian Handicap and Total Goals markets for EPL:\n```\ncurl -X 'GET' -H 'accept: application/json' -H 'X-API-Key: <API Key>' \\\n'https://sports-api.cloudbet.com/pub/v2/odds/competitions/soccer-england-premier-league?markets=soccer.matchOdds&markets=soccer.asianHandicap&markets=soccer.totalGoals'\n```\n\n2. Fetch Moneyline, Totals and Run Line markets for MLB:\n```\ncurl -X 'GET' -H 'accept: application/json' -H 'X-API-Key: <API Key>' \\\n'https://sports-api.cloudbet.com/pub/v2/odds/competitions/baseball-usa-mlb?markets=baseball.moneyline&markets=baseball.totals&markets=baseball.runLine'\n```\n\n### Code Samples\nYou can refer to [sample JavaScript code on Github](https://github.com/Cloudbet/docs/blob/master/api-sample.js) which guides you on how to obtain sport, competition, event and market information using the API.\nAfter downloading this script, you can run it locally by adding your API key within the script and then run the command: `node api-sample.js`\n\n### Response Samples\nYou can refer to [sample Feed API responses on Github](https://github.com/Cloudbet/docs/blob/master/api-responses.md) which gives you a preview of what to expect in our API responses.\n\n### API Schemas\nYou can refer to [Cloudbet API schemas](https://gist.github.com/kgravenreuth/6703e1e213aecac4d5728f2f699d34e7) which provide details about JSON objects returned within the Cloudbet API. This contains a full list of markets, sports and categories returned by our API.\n\n### Protobuf Schema and generated Go Protobuf files\nThe Protobuf schema definitions for all Cloudbet API endpoints is available within our [Github repo here](https://github.com/Cloudbet/docs/tree/master/cloudbet). You can also find generated [Go Protobuf files](https://github.com/Cloudbet/docs/tree/master/go/cloudbet). You can use this as a library within your Go client programs.\n\n### Event Status details\nEvents in the Cloudbet API can transition between different status such as `TRADING`, `TRADING_LIVE` etc. You can find details of these event status [here](https://github.com/Cloudbet/docs/blob/master/README.md#event-status)\n\n## Additional Resources\n1. [Trading (aka Betting) API Documentation](https://www.cloudbet.com/api/?urls.primaryName=Trading) The Trading API allows you to bet on Cloudbet odds obtained from the Feed API described on this page.\n2. [Account API Documentation](https://www.cloudbet.com/api/?urls.primaryName=Account) The Account API gives you information about your Cloudbet Account, such as available currencies etc.\n3. [Cloudbet Odds and Betting API Tutorial and Walkthrough blog post](https://www.cloudbet.com/en/blog/posts/sports-betting-api-tutorial-with-golang)\n4. [Cloudbet GraphQL Betting API Tutorial and Walkthrough blog post](https://www.cloudbet.com/en/blog/posts/sports-betting-graphql-api-with-javascript-node-js)\n5. [Postman Collection for Cloudbet Feed, Trading and Account APIs](https://www.postman.com/cloudbet/workspace/cloudbet-api/overview)\n6. [Cloudbet NPM SDK](https://www.npmjs.com/package/@cloudbet/market-helper). You can use this SDK to render markets.\n7. [CodeSandbox Demo of using our Feed API + SDK](https://codesandbox.io/s/cloudbet-odds-api-example-we1vk?file=/src/App.js)\n8. [Github Docs Discussions Page](https://github.com/Cloudbet/docs/discussions). Please feel free to raise any questions you may have about the Cloudbet API here. You can also find existing helpful answers from other Cloudbet API users.",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/cloudbet.com/cloudbet/2.0/apis.json",
  "tags": [
    "cloudbet.com",
    "cloudbet"
  ],
  "created": "2026-04-02",
  "modified": "2026-04-02",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "cloudbet.com:cloudbet-2.0",
      "name": "Cloudbet Feed API",
      "description": "The [Cloudbet](https://www.cloudbet.com/en/sports?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/) Feed API uses a long-lived API Key to allow secure access. The `API Key` used follows the JWT authentication standard. You can use these Odds API endpoints to obtain the latest market odds information from Cloudbet.\n\nThis API returns JSON or binary protobuf responses. For JSON responses, send the header `Content-Type: application/json`. For binary protobuf responses, send the header `Content-Type: application/x-protobuf`\n\n## Authentication with API Key\n\n### Trading API\n1. The Trading API (aka Betting API) is meant for developers who want to place bets and allows you to perform sports betting programatically. You can obtain the Cloudbet Trading `API Key` by logging into your Cloudbet Player account and navigating to the [\"My account -> API\" section](https://www.cloudbet.com/en/player/api?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/). For further details about how to use the Trading API, please refer to the [Trading API Documentation](https://www.cloudbet.com/api/?urls.primaryName=Trading)\n\n\n### Affiliate API\n1. The Affiliate API is primarily meant if you want to consume Cloudbet odds without needing to place bets programatically. You can obtain the Cloudbet Affiliate `API Key` by logging into your Cloudbet Affiliate account and then visiting the [Affiliate API Token](https://affiliates.cloudbet.com/affiliate_api_token?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/) page. Please note that there are 2 tokens on this page. Make sure to generate the token in the `API Key` section. Also, please take note of the `Expires at` timestamp mentioned in this section which is of a reasonably long duration. Your `API Key` will only be valid until this timestamp and you will have to create a new `API Key` again from the [Affiliate API Token](https://affiliates.cloudbet.com/affiliate_api_token?utmCampaign=axis&utmMedium=community&utmSource=www.cloudbet.com/api/) page before your current token expires to avoid your API calls from being rejected in the future.\n\n2. Using this Cloudbet Affiliate `API Key` you can then go back to https://www.cloudbet.com/api/ to test the Feed API endpoints as per the next section.\n\n3. If you authenticate with the Cloudbet Affiliate `API Key`, then the Feed API responses may be cached and up to 1 minute behind the latest updates. This is in contrast to using the Cloudbet Trading `API Key`, which gives you real-time updates.\n\n## Testing the Feed API\n\n1. Our Feed API expects the `API Key` from the previous section to be included in all API requests to the server in an HTTP header that looks like the following:\n\n`X-API-Key: <API Key>`\n\nYou must replace `<API Key>` with your own `API Key` as obtained in the previous section.\n\nExample with sample Trading `API Key`. Note that this is a standard JWT token.\n\n```\nX-API-Key: eyJhbGciOiJSUzI1NiIsImtpZCI6ImxPVGE3LXVQLVd2QUk1VjhfOHhiYWxjZWlIUmM1OHd6Wi02c21CWGE0Z2MiLCJ0eXAiOiJKV1QifQ.eyJhY2Nlc3NfdGllciI6InRyYWRpbmciLCJleHAiOjE5MzMyMzk2MjgsImlhdCI6MTYxNzg3OTYyOCwiaXNzIjoic3BvcnRzLXBsYXllcnMiLCJqdGkiOiJmZmExZjQ5MC00MzY4LTRhMjEtOGQxYy00NzFlM2FkZTAyYjYiLCJzdWIiOiJiZjA2YjFhZi0zZjM1LTQ2NWUtYTQyZC01Mjc2YTY1ODdmNTIiLCJ0ZW5hbnQiOiJjbG91ZGJldCIsInVzZXJfdXVpZCI6ImJmMDZiMWFmLTNmMzUtNDY1ZS1hNDJkLTUyNzZhNjU4N2Y1MiIsInV1aWQiOiJiZjA2YjFhZi0zZjM1LTQ2NWUtYTQyZC01Mjc2YTY1ODdmNTIifQ.LEwR9AOQ5FGhAKZPGjQ7dl1-0YYUsXbU1fNb17rhUqr_hh7SQipAOv9AlnO8vdExv0bHKrX0zX3_rAnpKdyo5Z6yVVkd-ovpvoTvoiP6gP8yoQqRnrqZKFjHtxHT1wsvqYiBhM52gWzWH77_9ccw5nh78yaxsd2PbZ9meYnqZY_M9x9HGyEU6xFaM1AZ6NaDlGp1iEgqm3atv88vJC75k9H-8Krlh06IwaJxkMnNkrq2cS-rGPDv6tK4jMYpfc7rhXj9ffOr9YOMLQ-fpv7y01hwZD94oUTVoHbAFjBYgMwkh9CdQFbLKZyV0Owb4rFM5BY-4kfKwQlvP9E0TdW3Hw\n```\n\n2. After authorization, click on any of the endpoints at https://www.cloudbet.com/api/ (e.g. `/sports`). Click on the `Authorize` button on the top right corner of the page, then enter `<API Key>`. This will authorize you to access our Feed API endpoints from within the OpenAPI GUI itself. Then click on `Try it out` and `Execute`. You will be able to see the API response on this page itself.\n\n## Samples and Supporting Documentation\nWe provide additional supporting documentation in our [Cloudbet/docs Github repo](https://github.com/Cloudbet/docs)\n\n### cURL Samples\nHere are some Feed API cURL samples illustrating the recommended way to ingest odds in bulk from the Cloudbet API.\nSpecifically, these samples demonstrate how to request specific Soccer and Baseball markets for the English Premier League (EPL) and Major League Baseball (MLB) competitions respectively.\n\n1. Fetch Match Odds, Asian Handicap and Total Goals markets for EPL:\n```\ncurl -X 'GET' -H 'accept: application/json' -H 'X-API-Key: <API Key>' \\\n'https://sports-api.cloudbet.com/pub/v2/odds/competitions/soccer-england-premier-league?markets=soccer.matchOdds&markets=soccer.asianHandicap&markets=soccer.totalGoals'\n```\n\n2. Fetch Moneyline, Totals and Run Line markets for MLB:\n```\ncurl -X 'GET' -H 'accept: application/json' -H 'X-API-Key: <API Key>' \\\n'https://sports-api.cloudbet.com/pub/v2/odds/competitions/baseball-usa-mlb?markets=baseball.moneyline&markets=baseball.totals&markets=baseball.runLine'\n```\n\n### Code Samples\nYou can refer to [sample JavaScript code on Github](https://github.com/Cloudbet/docs/blob/master/api-sample.js) which guides you on how to obtain sport, competition, event and market information using the API.\nAfter downloading this script, you can run it locally by adding your API key within the script and then run the command: `node api-sample.js`\n\n### Response Samples\nYou can refer to [sample Feed API responses on Github](https://github.com/Cloudbet/docs/blob/master/api-responses.md) which gives you a preview of what to expect in our API responses.\n\n### API Schemas\nYou can refer to [Cloudbet API schemas](https://gist.github.com/kgravenreuth/6703e1e213aecac4d5728f2f699d34e7) which provide details about JSON objects returned within the Cloudbet API. This contains a full list of markets, sports and categories returned by our API.\n\n### Protobuf Schema and generated Go Protobuf files\nThe Protobuf schema definitions for all Cloudbet API endpoints is available within our [Github repo here](https://github.com/Cloudbet/docs/tree/master/cloudbet). You can also find generated [Go Protobuf files](https://github.com/Cloudbet/docs/tree/master/go/cloudbet). You can use this as a library within your Go client programs.\n\n### Event Status details\nEvents in the Cloudbet API can transition between different status such as `TRADING`, `TRADING_LIVE` etc. You can find details of these event status [here](https://github.com/Cloudbet/docs/blob/master/README.md#event-status)\n\n## Additional Resources\n1. [Trading (aka Betting) API Documentation](https://www.cloudbet.com/api/?urls.primaryName=Trading) The Trading API allows you to bet on Cloudbet odds obtained from the Feed API described on this page.\n2. [Account API Documentation](https://www.cloudbet.com/api/?urls.primaryName=Account) The Account API gives you information about your Cloudbet Account, such as available currencies etc.\n3. [Cloudbet Odds and Betting API Tutorial and Walkthrough blog post](https://www.cloudbet.com/en/blog/posts/sports-betting-api-tutorial-with-golang)\n4. [Cloudbet GraphQL Betting API Tutorial and Walkthrough blog post](https://www.cloudbet.com/en/blog/posts/sports-betting-graphql-api-with-javascript-node-js)\n5. [Postman Collection for Cloudbet Feed, Trading and Account APIs](https://www.postman.com/cloudbet/workspace/cloudbet-api/overview)\n6. [Cloudbet NPM SDK](https://www.npmjs.com/package/@cloudbet/market-helper). You can use this SDK to render markets.\n7. [CodeSandbox Demo of using our Feed API + SDK](https://codesandbox.io/s/cloudbet-odds-api-example-we1vk?file=/src/App.js)\n8. [Github Docs Discussions Page](https://github.com/Cloudbet/docs/discussions). Please feel free to raise any questions you may have about the Cloudbet API here. You can also find existing helpful answers from other Cloudbet API users.",
      "image": "",
      "baseURL": "https://sports-api.cloudbet.com/pub",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/cloudbet.com/cloudbet/2.0",
      "version": "2.0",
      "tags": [
        "cloudbet.com",
        "cloudbet"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/cloudbet.com/cloudbet/2.0/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/cloudbet.com/cloudbet/2.0"
        }
      ]
    }
  ]
}