Push Feed to customer endpoint
https://[Partner-Name].racebookhq.com/api/host/betslip/decide
The Decision API sends back to partner the recommended limit for the bet.
Partner can use these details to display the information to the customer on the betslip.
The following is the definition for the Decision API
BetSlipSubmission
| Field | Type | Description | Comment |
|---|---|---|---|
| id | String | Partner betslip id | |
| customerId | String | Partner customer id. | This must also be present on the bet level since RBHQ also handles bets without betslips by configuration. |
| submissionTime | String | ISO fomat | Must also be the same time in each bet. |
| bets | List[BetSubmission] |
Within the list for bets in the BetSlipSubmission - submit the BetSubmission
| Field | Type | Description | Comment |
|---|---|---|---|
| id | String | Sportsbook transaction id | |
| customerId | String | Sportsbook customer id | |
| customerMeta | Map[String, String] | Optional map of customer related data | Optional field to provide more |
| type | String | The type of bet [RUNNING_DOUBLE, TREBLE, DAILY_DOUBLE, SINGLE, MULTI, QUADRELLA] | |
| stake | String | The amount specified for the bet. Formatted decimal | |
| stakeType | String | The stake type [CREDIT, BONUS, OTHER] | |
| currency | String | The currency the transactions are in. | We do not do currency conversions, this must be consistent across all bets. |
| submissionTime | String | The ISO format time of submission. | OPTIONAL for Bet Limit, REQUIRED for Betslip Decision and Betslip record |
| legs | List[LegSubmission] |
Within the List for legs in BetslipSubmission - submit the legsSubmission for each leg
LegSubmission
Definition
| Field | Type | Description | Comment |
|---|---|---|---|
| id | String | Partner transient id. | |
| type | String | The type of the leg [WIN, PLACE] | More types can come later. E.g EACH_WAY, TRIFECTA,… Supported sport bet types: HEAD_TO_HEAD, LINE, TOTAL, POINTS, MARGIN |
| eventId | String | The unique Racebook for Racing and external id for sport. | Please use meetingid:racenumber eg 1359871:3 so the meeting and race 3 |
| selectionSlots | List[SelectionSlot] | The object specifying the selection | Racing bets only require SELECTION slots. WIN and PLACE only have 1 selection slot. |
| prices | Map[String, String] | Map of bet tag to price. | Win and place will only have * mapped to a price since there is 1 universal price. Fixed odds exotics will be a distribution. |
| productType | String | The product type of the bet [FIXED_ODDS, PARIMUTUEL] | Use FIXED_ODDS |
| productDerivative | String | Derivative product code [SP, BT3SP] |
Within the List for SelectionSlot in LegSubmission - submit as per below definition
SelectionSlot
Definition
| Field | Type | Description | Comment |
|---|---|---|---|
| selections | List[String] | The runner numbers for the leg. | WIN and PLACE will only have 1 selection. |
| type | String | The type of selection slot. [SELECTION, MARKET,…] | Racing only uses SELECTION types. |
| selection | String | Used for Line and Total markets . | Sport only. Line and Total legs |
| reference | String | used to indicate if line is connected to selection a or b of h2h. Nullable | Sport Only. Line and Total Legs |
| line | String | Line or Total value | Sport Only. Line and Total Legs |
| marginType | String | Margin legs only. line or total enum | Sport Only. Margin legs |
| lower | String | Lower margin | Sport Only. Margin legs |
| upper | String | Upper margin | Sport Only. Margin legs |
The BetDecisions response will return the following fields as per the example.
The betSlip response
| Field | Type | Description | Comment |
|---|---|---|---|
| decisionsId | String | Provided by partner betslip id. | |
| classification | ProfileClassification | The classification of the customer | |
| decisions | List[BetDecison] | The bet decisions for each of the bets in the betslip (group) |
With in the betSlip the BetDecision for each bet.
| Field | Type | Description | Comment |
|---|---|---|---|
| betId | String | Provided by partner bet id | |
| status | String | The recommendation type. [ACCEPTED, REJECTED, PRICE_CHANGED, PARTIAL, INTERCEPTED] | |
| limit | String | The liability limit for the customer for the bet | |
| partialAmount | String | The amount recommended to bet if the status is PARTIAL | |
| reason | String | Description string about what happened | |
| reasonCode | String | Reason code for unsuccessful bet | 02 - Prices have changed. 03 - Outcome Suspended 04 - Event Closed 05 - Product is currenty unavailable 06 - Bet has a payout price less than minimum price 07 - Bet has a payout price greater than maximum price 08 - Liability Limit Reached 09 - Overridden by intercept |
| updatedPrices | Map[String, String] | New prices that changed before the bet has been submitted. | |
| dividends | String | The dividends used for determining limit | It might be of interest for same race multies |
{
"id": "slip1",
"customerId": "test1",
"submissionTime": "2021-04-15T05:12:23.664392+00:00",
"bets": [
{
"id": "b1",
"customerId": "test1",
"customerMeta": {
"residence": "AU"
},
"type": "SINGLE",
"stake": "55.00",
"stakeType": "CREDIT",
"currency": "USD",
"submissionTime": "2021-04-15T05:12:23.664392+00:00",
"legs": [
{
"id": "l1",
"type": "WIN",
"eventId": "test:race1",
"selectionSlots": [
{
"selections": [
"1"
],
"type": "SELECTION"
}
],
"prices": {
"*": "5.00"
},
"productType": "FIXED_ODDS"
}
]
},
{
"id": "b2",
"customerId": "test1",
"type": "SINGLE",
"stake": "5.50",
"stakeType": "CREDIT",
"currency": "USD",
"submissionTime": "2021-04-15T05:12:23.664392+00:00",
"legs": [
{
"id": "l2",
"type": "PLACE",
"eventId": "test:race1",
"selectionSlots": [
{
"selections": [
"1"
],
"type": "SELECTION"
}
],
"prices": {
"*": "1.75"
},
"productType": "FIXED_ODDS"
}
]
}
]
}
{
"id": "slip1",
"customerId": "test1",
"submissionTime": "2021-04-15T05:12:23.664392+00:00",
"bets": [
{
"id": "b1",
"customerId": "test1",
"type": "MULTI",
"stake": "55.00",
"stakeType": "CREDIT",
"currency": "USD",
"submissionTime": "2021-04-15T05:12:23.664392+00:00",
"legs": [
{
"id": "l1",
"type": "WIN",
"eventId": "test:race1",
"selectionSlots": [
{
"selections": [
"1"
],
"type": "SELECTION"
}
],
"prices": {
"*": "5.00"
},
"productType": "FIXED_ODDS"
},
{
"id": "l2",
"type": "PLACE",
"eventId": "test:race2",
"selectionSlots": [
{
"selections": [
"1"
],
"type": "SELECTION"
}
],
"prices": {
"*": "1.75"
},
"productType": "FIXED_ODDS"
}
]
}
]
}
[
{
"betId": "b1",
"status": "ACCEPTED",
"limit": 2180.024,
"liabilityLeft": 2180.024,
"partialAmount": 55.0,
"reason": "Bet accepted",
"dividends": 2.8,
"updatedPrices": {}
}
]
{
"id": "b9c55225-0f95-4830-a9d2-4be4e75f29c6",
"customerId": "19279",
"submissionTime": "2023-02-08T03:10:39Z",
"bets": [
{
"id": "2857ACB6-6E1D-426D-AB6C-CA8641BDCD4A",
"customerId": "19279",
"type": "SINGLE",
"stake": "15.00",
"stakeType": "CREDIT",
"currency": "AUD",
"submissionTime": "2023-02-08T03:10:39Z",
"legs": [
{
"id": "a4b640bb-11b2-4be2-ab7d-5a48eaace3db",
"type": "TRIFECTA",
"eventId": "1402804:1",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
},
{
"selections": [
"1",
"4",
"12"
],
"type": "SELECTION"
},
{
"selections": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"11",
"12"
],
"type": "SELECTION"
}
],
"productType": "PARIMUTUEL",
"isFlexible": true
}
]
}
],
"customerMeta": null
}
{
"id": "7b879458-cf99-49e4-a939-ac76b21b19e5",
"customerId": "20386",
"submissionTime": "2023-02-08T03:11:30Z",
"bets": [
{
"id": "990CDED3-E45C-4818-8D41-D27929D3D802",
"customerId": "20386",
"type": "SINGLE",
"stake": "4.00",
"stakeType": "CREDIT",
"currency": "AUD",
"submissionTime": "2023-02-08T03:11:30Z",
"legs": [
{
"id": "69351969-7eaf-4fa5-9944-6a74c993d3ee",
"type": "QUINELLA",
"eventId": "1402840:8",
"selectionSlots": [
{
"selections": [
"5"
],
"type": "SELECTION"
},
{
"selections": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8"
],
"type": "SELECTION"
}
],
"productType": "PARIMUTUEL",
"isFlexible": true
}
]
}
],
"customerMeta": null
}
{
"id": "2f4d6978-1331-4f74-bcbd-16bbb1141260",
"customerId": "20386",
"submissionTime": "2023-02-08T03:11:37Z",
"bets": [
{
"id": "8609F442-5154-42AD-B8EF-4A71B253B386",
"customerId": "20386",
"type": "SINGLE",
"stake": "8.00",
"stakeType": "CREDIT",
"currency": "AUD",
"submissionTime": "2023-02-08T03:11:37Z",
"legs": [
{
"id": "1676bfec-3962-4016-9078-d32f6d2a745f",
"type": "EXACTA",
"eventId": "1402840:8",
"selectionSlots": [
{
"selections": [
"5",
"1",
"2",
"3",
"4",
"6",
"7",
"8"
],
"type": "SELECTION"
},
{
"selections": [
"5",
"1",
"2",
"3",
"4",
"6",
"7",
"8"
],
"type": "SELECTION"
}
],
"productType": "PARIMUTUEL",
"isFlexible": true
}
]
}
],
"customerMeta": null
}
{
"id": "70c52f9d-8d74-4c32-88d5-349dedb3ffd9",
"customerId": "13181",
"submissionTime": "2023-02-08T03:10:10Z",
"bets": [
{
"id": "BE3F8D08-4211-42BA-82D5-40F69EEBA514",
"customerId": "13181",
"type": "SINGLE",
"stake": "6.00",
"stakeType": "CREDIT",
"currency": "AUD",
"submissionTime": "2023-02-08T03:10:10Z",
"legs": [
{
"id": "d1395812-35d2-47f7-b294-7f6a5405a026",
"type": "EACH_WAY",
"eventId": "1402804:1",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"prices": {
"WIN": "2.00",
"PLACE": "1.20"
},
"productType": "FIXED_ODDS",
"isFlexible": false
}
]
}
],
"customerMeta": null
}
{
"bets": [
{
"currency": "AUD",
"customerId": "c68fe4a3-18fb-430d-8cd7-56ed117e0dd2",
"id": "2f37d18b-1598-4718-953c-942f4e93610b",
"legs": [
{
"eventId": "1403604:8",
"id": "9b79e6b6-4629-48ec-8685-0e60e2b53b67",
"prices": {
"*": "2.9"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"4"
],
"type": "SELECTION"
},
{
"selections": [],
"type": "SELECTION"
},
{
"selections": [],
"type": "SELECTION"
},
{
"selections": [
"5",
"1"
],
"type": "SELECTION"
}
],
"type": "SAME_RACE_MULTI"
}
],
"stake": "10.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-20T02:20:31.062233Z",
"type": "SINGLE"
}
],
"customerId": "c68fe4a3-18fb-430d-8cd7-56ed117e0dd2",
"id": "12345",
"submissionTime": "2023-02-20T02:20:31.062233Z"
}
{
"bets": [
{
"currency": "AUD",
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "48296a52-e98f-41d8-b0b5-5d3952d9c121",
"legs": [
{
"eventId": "1402867:3",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f4",
"prices": {
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:4",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f41",
"prices": {
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:5",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices": {
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
}
],
"stake": "25.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-06T23:34:24.184878Z",
"type": "TREBLE"
}
],
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "",
"submissionTime": "2023-02-06T23:34:24.184878Z"
}
{
"bets": [
{
"currency": "AUD",
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "48296a52-e98f-41d8-b0b5-5d3952d9c121",
"legs": [
{
"eventId": "1402867:3",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f4",
"prices": {
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:4",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f41",
"prices": {
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:5",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices": {
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:6",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices": {
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots": [
{
"selections": [
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
}
],
"stake": "25.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-06T23:34:24.184878Z",
"type": "QUADRELLA"
}
],
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "",
"submissionTime": "2023-02-06T23:34:24.184878Z"
}
{
"bets":
[
{
"currency": "AUD",
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "48296a52-e98f-41d8-b0b5-5d3952d9c121",
"legs":
[
{
"eventId": "1402867:1",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f4",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:2",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f41",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:3",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices":
{
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:4",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices":
{
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
}
],
"stake": "25.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-06T23:34:24.184878Z",
"type": "EARLY_QUADRELLA"
}
],
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "",
"submissionTime": "2023-02-06T23:34:24.184878Z"
}
{
"bets":
[
{
"currency": "AUD",
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "48296a52-e98f-41d8-b0b5-5d3952d9c121",
"legs":
[
{
"eventId": "1402867:5",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f4",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:6",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f41",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:7",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices":
{
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:8",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices":
{
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:9",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices":
{
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:10",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f42",
"prices":
{
"*": "1.95"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
}
],
"stake": "25.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-06T23:34:24.184878Z",
"type": "BIG_SIX"
}
],
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "",
"submissionTime": "2023-02-06T23:34:24.184878Z"
}
{
"bets":
[
{
"currency": "AUD",
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "48296a52-e98f-41d8-b0b5-5d3952d9c121",
"legs":
[
{
"eventId": "1402867:5",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f4",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:6",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f41",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
}
],
"stake": "25.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-06T23:34:24.184878Z",
"type": "DAILY_DOUBLE"
}
],
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "",
"submissionTime": "2023-02-06T23:34:24.184878Z"
}
{
"bets":
[
{
"currency": "AUD",
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "48296a52-e98f-41d8-b0b5-5d3952d9c121",
"legs":
[
{
"eventId": "1402867:5",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f4",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
},
{
"eventId": "1402867:6",
"id": "7ec8af7a-4228-4b6b-aaed-d2e6738790f41",
"prices":
{
"*": "3.8"
},
"productType": "FIXED_ODDS",
"selectionSlots":
[
{
"selections":
[
"8"
],
"type": "SELECTION"
}
],
"type": "WIN"
}
],
"stake": "25.0",
"stakeType": "CREDIT",
"submissionTime": "2023-02-06T23:34:24.184878Z",
"type": "RUNNING_DOUBLE"
}
],
"customerId": "f6292813-cd31-4281-9de8-f4c18e802085",
"id": "",
"submissionTime": "2023-02-06T23:34:24.184878Z"
}