Pinnacle API Documentation
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
APIChangelog.md typo fix Jan 9, 2019
FAQ.md Update: How to find associated events? Jan 9, 2019
FairUsePolicy.md Fair usage updated with /sports and /leagues Jan 18, 2019
GettingStarted.md Added Getting Started Jun 20, 2018
README.md added notice about junk inbox Sep 11, 2018

README.md

Overview

Pinnacle API is a RESTful service for betting all bet types on all sports.

Authentication

The API uses HTTP Basic access authentication. Always use HTTPS to access the API.

You need to send HTTP Request header like this:

Authorization: Basic <Base64 value of UTF-8 encoded “username:password”> 

Example:

Authorization: Basic U03MyOT23YbzMDc6d3c3O1DQ1 

Please note that in order to access Pinnacle API, you must have a funded account.

Data Formats

Pinnacle API supports only JSON format. HTTP header Accept must be set:

    Accept: application/json

POST HTTP Request must have JSON body content and Content-Type HTTP header must be set:

    Content-Type: application/json

Compression

Pinnacle API supports HTTP compression. We strongly recommend using compression as it would give the best performance.

Please make sure to set the User-Agent HTTP header or compression might not work.

Date Time Format

All dates and times are in GMT time zone, ISO 8601 format

Deduplication

When a client issues a network request, it is always possible for the request to timeout or return an error status code indicating that the bet may not have been accepted. This opens up the possibility of the same request being sent more than once, which could create duplicate bets. Deduplication is a technique to avoid creating these duplicates when retrying a create request. We do the deduplication automatically for you.

If the bet is accepted, we store the uniqueRequestId in the system for 30 min. If you try again within that time range to place a bet with the same uniqueRequestId, you will get the appropriate error.

All place bet requests support deduplication.

API Reference

Pinnacle API Open API Specification is hosted on GitHub.

The API reference documentation:

Lines API

Bets API

Customer API

More ...

Getting Started

API Change Log

FAQ

Fair Use Policy

API Status

You can follow pinnacle status page and subscribe to get the notifications on API status. Notifications will be sent from noreply@mg.pinnacle.com, make sure you check your junk inbox.

Libraries

R

Please use the pinnacle.API package available on CRAN. (install.packages(“pinnacle.API”)) The source code can be found here.

Disclaimer

Pinnacle is not liable for use of the API for any purpose. The API is provided on an “as is” and “as available” basis, without warranties of any kind, either expressed or implied, including, without limitation, implied warranties of merchantability and fitness for a particular purpose or non-infringement.