Skip to content

Latest commit

 

History

History
158 lines (96 loc) · 6 KB

GettingStarted.md

File metadata and controls

158 lines (96 loc) · 6 KB

Getting Started

Step 1 - Get Approval to Access the API

Please note that Pinnacle API is not available to all customers. To request the access please contact Pinnacle Solution.

Step 2 - Get a List of Offered Sports and Leagues

You would need to get the list of sports from the Get Sports operation. If you are interested in particular leagues, you can get all sports leagues by calling the Get Leagues operation.

Step 3 - Place Bet

To place a bet, please check the below section How to place a bet.

Step 4 - Get Bets

To check the status of the placed bet, you need to call Get Bets operation. The recommended way is to use betIds query parameter.

How to Place a Bet

Straight Bet

Step 1 - Call Get Fixtures operation

This will return the list of events that are currently offered. To get updates, use delta requests (with since parameter)

Step 2 - Call Get Odds operation

This will return the list of odds that are currently offered. To get updates, use delta requests (with since parameter)

Step 3 (Optional) - Get Line

Call Get Line operation if you need exact limits or if you are interested in a specific line. Please note that the limits in the Get Odds response are general.

Step 4 - Place Bet

To place a bet you need to call Place Bet operation.

Table shows how to do mapping of Get Odds operation response to Place Bet and Get Line request.

ParameterGet Odds response parameter
sportId sportId
leagueId League Type -> id
eventId Event Type -> id
periodNumber Period Type -> number
team

Depends on selected odds from:

· Spread Type
· Moneyline Type
· Team Total Points

check the value in the corresponding Get Leagues Response -> League Type -> homeTeamType and set the appropriate value.

Example 1:

Given:
    homeTeamType="Team1"
When:
    Selected odds is Spread Type -> away
Then:
    team=Team2

Example 2:

When:
    Selected odds is Moneyline Type -> draw
Then:
    team=Draw

Example 3:

Given:
    homeTeamType="Team2"
When:
    Selected odds is Team Total Points Type -> away
Then:
    team=Team1

handicap Spread Type -> hdp
Total Points Type -> points
Team Total Points Type -> Total Points Type -> points
lineId Period Type -> lineId
altLineId Spread Type ->altLineId
Total Points Type -> altLineId

IMPORTANT: Make sure you use both the lineId and altLineId from the Get Line or Get Odds response when placing a bet. If you the price was for alternate line and you omit to set the altLineId parameter in the place bet request, the bet will be placed on the main line.

Parlay Bet

Step 1 – Call Get Fixtures operation

This will return the list of events that are currently offered. To get updates use delta requests (with since parameter)

Step 2 – Call Get Odds operation

This will return the list of odds that are currently offered. To get updates use delta requests (with since parameter)

Step 3 – Call Get Parlay Lines operation

For each event and bet type you want to bet on, construct a Leg object for Get Parlay Lines call and submit your request using: POST /line/parlay -> If response contains Invalid Legs – remove them and resubmit the request -> If response has status = ‘VALID’ – place parlay bet request can be created

Step 4 – Call Place Parlay Bet

Construct a list of legs using lineId values from Get Parlay Lines response and specify roundRobbinOptions out of those returned in Get Parlay Lines response.

Teaser Bet

Step 1 – Call Get Teaser Groups operation

This will return the list of teasers by group containing all the details for each teaser. For example; the minimum/maximum number of legs, payout combinations for the chosen teaser and leagues for each teaser.

Step 2 – Call Get Teaser Odds operation

This will return the list of adjusted points that are currently offered for the given teaser.

Step 3 (Optional) – Call Get Teaser Lines operation

Prior to submitting a teaser bet you can call this endpoint to validate your proposed bet, calculate the effective minimum/maximum win/risk bet limits, as well as get the price you will receive for the bet without actually placing a bet.

Step 4 – Call Place Teaser Bet operation

Using the information obtained from the previous steps, build and place your bet.

Special Bet

Step 1 – Call Get Special Fixtures operation

This will return the list of specials that are currently offered. To get updates use delta requests (with since parameter)

Step 2 – Call Get Special Odds operation

This will return the list of special odds that are currently offered. To get updates use delta requests (with since parameter)

Step 3 (Optional) - Call Get Special Lines operation

Prior to submitting a special bet, you can call this endpoint to validate your proposed bet, calculate the effective minimum/maximum win/risk bet limits, as well as get the price you will receive for the bet without actually placing a bet.

Step 4 – Call Place Special Bet operation

Using the information obtained from the previous steps, build and place your bet.