Cloudbet Feed API

Developer Tools
Download This Spec

About this spec

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. This 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` ## Authentication with API Key ### Trading API 1. 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) ### Affiliate API 1. 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. 2. 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. 3. 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. ## Testing the Feed API 1. 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: `X-API-Key: <API Key>` You must replace `<API Key>` with your own `API Key` as obtained in the previous section. Example with sample Trading `API Key`. Note that this is a standard JWT token. ``` X-API-Key: eyJhbGciOiJSUzI1NiIsImtpZCI6ImxPVGE3LXVQLVd2QUk1VjhfOHhiYWxjZWlIUmM1OHd6Wi02c21CWGE0Z2MiLCJ0eXAiOiJKV1QifQ.eyJhY2Nlc3NfdGllciI6InRyYWRpbmciLCJleHAiOjE5MzMyMzk2MjgsImlhdCI6MTYxNzg3OTYyOCwiaXNzIjoic3BvcnRzLXBsYXllcnMiLCJqdGkiOiJmZmExZjQ5MC00MzY4LTRhMjEtOGQxYy00NzFlM2FkZTAyYjYiLCJzdWIiOiJiZjA2YjFhZi0zZjM1LTQ2NWUtYTQyZC01Mjc2YTY1ODdmNTIiLCJ0ZW5hbnQiOiJjbG91ZGJldCIsInVzZXJfdXVpZCI6ImJmMDZiMWFmLTNmMzUtNDY1ZS1hNDJkLTUyNzZhNjU4N2Y1MiIsInV1aWQiOiJiZjA2YjFhZi0zZjM1LTQ2NWUtYTQyZC01Mjc2YTY1ODdmNTIifQ.LEwR9AOQ5FGhAKZPGjQ7dl1-0YYUsXbU1fNb17rhUqr_hh7SQipAOv9AlnO8vdExv0bHKrX0zX3_rAnpKdyo5Z6yVVkd-ovpvoTvoiP6gP8yoQqRnrqZKFjHtxHT1wsvqYiBhM52gWzWH77_9ccw5nh78yaxsd2PbZ9meYnqZY_M9x9HGyEU6xFaM1AZ6NaDlGp1iEgqm3atv88vJC75k9H-8Krlh06IwaJxkMnNkrq2cS-rGPDv6tK4jMYpfc7rhXj9ffOr9YOMLQ-fpv7y01hwZD94oUTVoHbAFjBYgMwkh9CdQFbLKZyV0Owb4rFM5BY-4kfKwQlvP9E0TdW3Hw ``` 2. 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. ## Samples ### Code Samples You 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. After 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` ### Response Samples You 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. ### API Schemas You can refer to [Cloudbet API schemas](https://gist.github.com/kgravenreuth/6703e1e213aecac4d5728f2f699d34e7) which provide details about JSON objects returned within the Cloudbet API.

About Versori

Versori has established itself as the third generation of Integration Platform as a Service (iPaaS). Versori builds custom integrations for its customers using an intuitive visual user interface.

Versori’s connector engine means there is no dependency on an existing library of apps, all you need to start is the documentation of the app or system you want to integrate to.

How can I integrate with this spec?

Upload your spec

Drag and drop the Open API Spec into Versori's connector engine to create a new connector in minutes.

Build your workflow

Build out visual integration workflows with powerful data tools on an intuitive canvas UI.

Deploy instantly

Deploy your automated workflow instantly and maintain your integrations with ease.

Issue with this spec?

Is there something wrong with this spec? Let us know and Versori's engineering team will improve the quality of the spec based on your feedback.

Report This Spec
Built for Security & Scale

How developers maximise their time & productivity with Versori

Easily map complex data fields

Automatically match and transform data fields between systems with precision, reducing manual effort and errors.

Build, integrate & deploy faster

Design integrations visually, test workflows instantly, and deploy seamlessly—accelerating your time to value.

Create any custom connector in minutes

Drag and drop API specifications to build custom integrations, unlocking endless connectivity with minimal setup.

Start building today

Ready to start integrating?

Google Ads
Batch
Dropbox
Airtable
Asana
Calendly
Filter