Third-Party integration overview

You can manage the configuration and issuance of free bets through our admin panel. Additionally, we provide a special API that allows for third-party integration with your systems without the need to use our admin panel.

Please refer to the Bonus External section in the documentation (opens in a new tab).

Authorization

Access to the API is provided via an API token, which should be included in the x-bonus-api-token header. To obtain a token, please contact us (opens in a new tab).

Example:

curl -X 'POST' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/offer/freebet/create' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api-token' \
  -H 'Content-Type: application/json'

General methods

Create freebet offer

Endpoint: /api/v1/public/bonus/external/offer/freebet/create

Request: CreateFreebetOfferDto

Response: OfferResponse

Example:

curl -X 'POST' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/offer/freebet/create' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Offer Name",
  "key": "offer_key",
  "publicCustomData": {
    "color": 2321,
    "publicName": "Test freebet"
  },
  "description": "description text",
  "settings": {
    "bonusType": "AllWin",
    "feeSponsored": true,
    "betRestriction": {
      "betType": "All",
      "minOdds": "1.5",
      "maxOdds": "2.0"
    },
    "eventRestriction": {
      "eventStatus": "All",
      "eventFilter": {
        "exclude": false,
        "filter": [
          {
            "sportId": "1",
            "leagues": [
              "Premier League",
              "La Liga"
            ],
            "markets": [
              {
                "marketId": 1,
                "gamePeriodId": 1,
                "gameTypeId": 1
              }
            ]
          }
        ]
      }
    },
    "periodOfValidityMs": 86400000
  }
}'

Create bonus by offer

Endpoint: /api/v1/public/bonus/external/create

Request: CreateBonusDto

Response: BonusesResponse

Example:

curl -X 'POST' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/create' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token' \
  -H 'Content-Type: application/json' \
  -d '{
  "offerId": "f3f2e850-b5d4-11ef-ac7e-96584d5248b5",
  "poolId": "5cf0db52-1a86-46d3-abbf-df262c5be39c",
  "recipients": [
    {
      "address": "f3f2e850-b5d4-11ef-ac7e-96584d5248b5",
      "amount": "100"
    }
  ],
  "campaignGroup": "campaign-group-1"
}'

Get offers list

Endpoint: /api/v1/public/bonus/external/offer/list

Response: OffersResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/offer/list' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Get bonuses

Endpoint: /api/v1/public/bonus/external/list

Response: BonusesResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/list' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Statistic methods

These methods display statistics on the bonuses issued

Get bonus statistics by campaign

Endpoint: /api/v1/public/bonus/external/statistics/freebet/by-campaign

Response: BonusStatisticsByCampaignResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/statistics/freebet/by-campaign' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Get bonus statistics by pool

Endpoint: /api/v1/public/bonus/external/statistics/freebet/by-pool

Response: BonusStatisticsByPoolResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/statistics/freebet/by-pool' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Get pools list

Endpoint: /api/v1/public/bonus/external/pool/list

Response: PoolsResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/pool/list' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Utils methods

These methods function as utilities for collecting supplementary information required when constructing an eventFilter

Get unique markets combinations

Endpoint: /api/v1/public/bonus/external/utils/markets-combinations

Parameters:

sportId (required): Sport ID

Response: SportsUniqueMarketsCombinationsResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/utils/markets-combinations?sportId=33' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Get actual sport IDs

Endpoint: /api/v1/public/bonus/external/utils/markets-combinations/sports

Response: ActualSportIdsResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/utils/markets-combinations/sports' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Get actual leagues

Endpoint: /api/v1/public/bonus/external/utils/leagues

Parameters:

sportIds (optional): Array of sport IDs
startsAtFrom (optional): From time (timestamp)
startsAtTo (optional): To time (timestamp)

Response: ActualLeaguesResponse

Example:

curl -X 'GET' \
  'https://api.onchainfeed.org/api/v1/public/bonus/external/utils/leagues?sportIds=33&startsAtFrom=1742216019000&startsAtTo=1743339219000' \
  -H 'accept: application/json' \
  -H 'x-bonus-api-token: api_token'

Use Freebets Data types