- 身份验证
- Fixtures
  - get获取赛程 - v3
  - get获取特殊赛程 - v2
  - get获取已结算赛程 - v3
  - get获取已结算特殊赛程 - v3
- Odds
  - get获取直盘赔率 - v3
  - get获取直盘赔率 - v4
  - get获取串关赔率 - v3
  - get获取串关赔率 - v4
  - get获取过关赔率 - v1
  - get获取特殊赔率 - v2
- Line
  - get获取直盘线 - v2
  - post获取串关线 - v3
  - post获取过关线 - v1
  - get获取特殊线 - v2
- Others
  - get获取运动项目 - v3
  - get获取联赛 - v3
  - get获取周期 - v1
  - get获取进行中赛事 - v2
  - get获取过关组 - v1
  - get获取取消原因 - v1
  - get获取货币 - v2

API docs by Redocly

# Pinnacle888 - Lines API 参考文档 (1.0.0)

Download OpenAPI specification:

关于赔率和赛程的所有信息

## 身份验证

API 使用 HTTP Basic 访问身份验证。您需要发送 Authorization HTTP 请求头：

`Authorization: Basic <Base64 value of UTF-8 encoded "username:password">`

示例：

`Authorization: Basic U03MyOT23YbzMDc6d3c3O1DQ1`

## Fixtures

## 获取赛程 - v3

返回指定运动的所有未结算赛事。请注意，赛事可能出现在 Get Fixtures 响应中，但不在 Get Odds 中。这种情况发生在赔率目前不可用于投注时。请注意，使用 since 参数时，可能会收到完全相同的响应。这种情况很少见，可能是由于赛事属性的内部更新导致的。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要获取赛程的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
isLive | boolean 要仅检索直播赛事，请将值设置为 1 (isLive=1)。缺少或任何其他值将导致检索所有赛事，无论其直播状态如何。
since | integer <int64> 用于接收增量更新。使用上次 fixtures 响应中的 last 值。如果不提供 since 参数，赛程最多会延迟 1 分钟，以鼓励使用该参数。
eventIds | Array of integers <int32> [ items <int32 > ] 用于过滤的逗号分隔的赛事 ID 列表

### Responses

https://api.pinnacle888.com/v3/fixtures

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "league":
  [
  - {
    - "id": 0,
    - "name": "string",
    - "events":
      [
      - {
        - "id": 0,
        - "parentId": 0,
        - "starts": "2019-08-24T14:15:22Z",
        - "home": "string",
        - "away": "string",
        - "liveStatus": 0,
        - "homePitcher": "string",
        - "awayPitcher": "string",
        - "betAcceptanceType": 0,
        - "parlayRestriction": 0,
        - "altTeaser": true,
        - "resultingUnit": "string",
        - "version": 0
        }
      ]
    }
  ]

}`

## 获取特殊赛程 - v2

返回指定运动的所有未结算特殊赛事。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索特殊赛事的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
since | integer <int64> 用于接收增量更新。使用上次响应中的 last 字段值。如果不提供 since 参数，赛程最多会延迟 1 分钟，以鼓励使用该参数。
category | string 特殊赛事所属的类别。
eventId | integer <int64> 与特殊赛事关联的赛事 ID。
specialId | integer <int64> 特殊赛事的 ID。

### Responses

https://api.pinnacle888.com/v2/fixtures/special

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 4,
- "last": 636433059508250600,
- "leagues":
  [
  - {
    - "id": 487,
    - "specials":
      [
      - {
        - "id": 1,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 4th quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "I",
        - "event":
          {
          - "id": 1,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 1,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 2,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 2,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 3rd quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "I",
        - "event":
          {
          - "id": 1,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 3,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 4,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 3,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 2nd quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "H",
        - "event":
          {
          - "id": 1,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 5,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 6,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 4,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 1st quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "I",
        - "event":
          {
          - "id": 1,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 7,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 8,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 5,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 4th quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": null,
        - "event":
          {
          - "id": 2,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 9,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 10,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 6,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 3rd quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "I",
        - "event":
          {
          - "id": 2,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 11,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 12,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 7,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 2nd quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "I",
        - "event":
          {
          - "id": 2,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 13,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 14,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 8,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Will the 1st quarter be odd or even?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "1/4 Totals",
        - "units": "",
        - "status": "H",
        - "event":
          {
          - "id": 2,
          - "periodNumber": 0
          },
        - "contestants":
          [
          - {
            - "id": 15,
            - "name": "Odd",
            - "rotNum": 100
            },
          - {
            - "id": 16,
            - "name": "Even",
            - "rotNum": 101
            }
          ]
        },
      - {
        - "id": 9,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Who will win the NBA finals?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "Outright Winner",
        - "units": "",
        - "status": "I",
        - "contestants":
          [
          - {
            - "id": 17,
            - "name": "Golden State Warriors",
            - "rotNum": 100
            },
          - {
            - "id": 18,
            - "name": "Cleveland Cavaliers",
            - "rotNum": 101
            },
          - {
            - "id": 19,
            - "name": "San Antonio Spurs",
            - "rotNum": 102
            },
          - {
            - "id": 20,
            - "name": "Chicago Bulls",
            - "rotNum": 103
            }
          ]
        }
      ]
    },
  - {
    - "id": 578,
    - "specials":
      [
      - {
        - "id": 10,
        - "betType": "MULTI_WAY_HEAD_TO_HEAD",
        - "name": "Who will win the WNBA finals?",
        - "date": "2017-10-11T14:00:00Z",
        - "cutoff": "2017-10-11T14:00:00Z",
        - "category": "Outright Winner",
        - "units": "",
        - "status": "I",
        - "contestants":
          [
          - {
            - "id": 21,
            - "name": "Minnesota Lynx",
            - "rotNum": 100
            },
          - {
            - "id": 22,
            - "name": "Indiana Fever",
            - "rotNum": 101
            },
          - {
            - "id": 23,
            - "name": "Phoenix Mercury",
            - "rotNum": 102
            },
          - {
            - "id": 24,
            - "name": "Chicago Sky",
            - "rotNum": 103
            }
          ]
        }
      ]
    }
  ]

}`

## 获取已结算赛程 - v3

返回指定运动在过去 24 小时内已结算的赛程。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索已结算赛事的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
since | integer <int64> 用于接收增量更新。使用上次响应中的 last 字段值。

### Responses

https://api.pinnacle888.com/v3/fixtures/settled

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "events":
      [
      - {
        - "id": 0,
        - "periods":
          [
          - {
            - "number": 0,
            - "status": 0,
            - "settlementId": 0,
            - "settledAt": "2017-09-03T18:21:22.3846289-07:00",
            - "team1Score": 0,
            - "team2Score": 0,
            - "cancellationReason":
              {
              - "code": "string",
              - "details":
                {
                - "correctTeam1Id": "string",
                - "correctTeam2Id": "string",
                - "correctListedPitcher1": "string",
                - "correctListedPitcher2": "string",
                - "correctSpread": "0.0",
                - "correctTotalPoints": "0.0",
                - "correctTeam1TotalPoints": "0.0",
                - "correctTeam2TotalPoints": "0.0",
                - "correctTeam1Score": "0",
                - "correctTeam2Score": "0",
                - "correctTeam1TennisSetsScore": "0",
                - "correctTeam2TennisSetsScore": "0"
                }
              }
            }
          ]
        }
      ]
    }
  ]

}`

## 获取已结算特殊赛程 - v3

返回指定运动在过去 24 小时内已结算的所有特殊赛事。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索已结算特殊赛事的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组。这是可选参数。
since | integer <int64> 用于接收增量更新。使用上次响应中的 last 字段值。

### Responses

https://api.pinnacle888.com/v3/fixtures/special/settled

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "specials":
      [
      - {
        - "id": 0,
        - "status": 0,
        - "settlementId": 0,
        - "settledAt": "2017-10-11T15:05:50.996671Z",
        - "contestants":
          [
          - {
            - "id": 1,
            - "name": "Barranquilla",
            - "outcome": "X"
            },
          - {
            - "id": 2,
            - "name": "Valledupar",
            - "outcome": "X"
            }
          ],
        - "cancellationReason":
          {
          - "code": "string",
          - "details":
            {
            - "correctTeam1Id": "string",
            - "correctTeam2Id": "string",
            - "correctListedPitcher1": "string",
            - "correctListedPitcher2": "string",
            - "correctSpread": "0.0",
            - "correctTotalPoints": "0.0",
            - "correctTeam1TotalPoints": "0.0",
            - "correctTeam2TotalPoints": "0.0",
            - "correctTeam1Score": "0",
            - "correctTeam2Score": "0",
            - "correctTeam1TennisSetsScore": "0",
            - "correctTeam2TennisSetsScore": "0"
            }
          }
        }
      ]
    }
  ]

}`

## Odds

## 获取直盘赔率 - v3 Deprecated

返回所有未结算赛事的直盘赔率。请注意，赛事可能出现在 Get Fixtures 响应中，但不在 Get Odds 中。这种情况发生在赔率目前不可用于投注时。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索赔率的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
oddsFormat | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。默认为 American。[American, Decimal, HongKong, Indonesian, Malay]
since | integer <int64> 用于接收增量更新。使用上次 odds 响应中的 last 值。如果不提供 since 参数，赔率最多会延迟 1 分钟，以鼓励使用该参数。请注意，使用 since 参数时，响应中只包含已更改的周期。如果某个周期没有任何更改，它将不会出现在响应中。
isLive | boolean 要仅检索直播赔率，请将值设置为 1 (isLive=1)。否则响应将包含所有赔率。
eventIds | Array of integers <int64> [ items <int64 > ] 按 EventIds 过滤
toCurrencyCode | string 3 字母货币代码，如 /currency 响应中所示。限额将以请求的货币返回。默认为 USD。

### Responses

https://api.pinnacle888.com/v3/odds

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "events":
      [
      - {
        - "id": 0,
        - "awayScore": 0.1,
        - "homeScore": 0.1,
        - "awayRedCards": 0,
        - "homeRedCards": 0,
        - "periods":
          [
          - {
            - "lineId": 0,
            - "number": 0,
            - "cutoff": "2019-08-24T14:15:22Z",
            - "status": 1,
            - "maxSpread": 0.1,
            - "maxMoneyline": 0.1,
            - "maxTotal": 0.1,
            - "maxTeamTotal": 0.1,
            - "moneylineUpdatedAt": "2019-08-24T14:15:22Z",
            - "spreadUpdatedAt": "2019-08-24T14:15:22Z",
            - "totalUpdatedAt": "2019-08-24T14:15:22Z",
            - "teamTotalUpdatedAt": "2019-08-24T14:15:22Z",
            - "spreads":
              [
              - {
                - "altLineId": 0,
                - "hdp": 0.1,
                - "home": 0.1,
                - "away": 0.1,
                - "max": 0.1
                }
              ],
            - "moneyline":
              {
              - "home": 0.1,
              - "away": 0.1,
              - "draw": 0.1
              },
            - "totals":
              [
              - {
                - "altLineId": 0,
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1,
                - "max": 0.1
                }
              ],
            - "teamTotal":
              {
              - "home":
                {
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1
                },
              - "away":
                {
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1
                }
              },
            - "awayScore": 0.1,
            - "homeScore": 0.1,
            - "awayRedCards": 0,
            - "homeRedCards": 0
            }
          ]
        }
      ]
    }
  ]

}`

## 获取直盘赔率 - v4

返回所有未结算赛事的直盘赔率。请注意，赛事可能出现在 Get Fixtures 响应中，但不在 Get Odds 中。这种情况发生在赔率目前不可用于投注时。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索赔率的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
oddsFormat | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。默认为 American。[American, Decimal, HongKong, Indonesian, Malay]
since | integer <int64> 用于接收增量更新。使用上次 odds 响应中的 last 值。如果不提供 since 参数，赔率最多会延迟 1 分钟，以鼓励使用该参数。请注意，使用 since 参数时，响应中只包含已更改的周期。如果某个周期没有任何更改，它将不会出现在响应中。
isLive | boolean 要仅检索直播赔率，请将值设置为 1 (isLive=1)。否则响应将包含所有赔率。
eventIds | Array of integers <int64> [ items <int64 > ] 按 EventIds 过滤
toCurrencyCode | string 3 字母货币代码，如 /currency 响应中所示。限额将以请求的货币返回。默认为 USD。

### Responses

https://api.pinnacle888.com/v4/odds

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "events":
      [
      - {
        - "id": 0,
        - "awayScore": 0.1,
        - "homeScore": 0.1,
        - "awayRedCards": 0,
        - "homeRedCards": 0,
        - "periods":
          [
          - {
            - "lineId": 0,
            - "number": 0,
            - "cutoff": "2019-08-24T14:15:22Z",
            - "status": 1,
            - "maxSpread": 0.1,
            - "maxMoneyline": 0.1,
            - "maxTotal": 0.1,
            - "maxTeamTotal": 0.1,
            - "moneylineUpdatedAt": "2019-08-24T14:15:22Z",
            - "spreadUpdatedAt": "2019-08-24T14:15:22Z",
            - "totalUpdatedAt": "2019-08-24T14:15:22Z",
            - "teamTotalUpdatedAt": "2019-08-24T14:15:22Z",
            - "spreads":
              [
              - {
                - "altLineId": 0,
                - "hdp": 0.1,
                - "home": 0.1,
                - "away": 0.1,
                - "max": 0.1
                }
              ],
            - "moneyline":
              {
              - "home": 0.1,
              - "away": 0.1,
              - "draw": 0.1
              },
            - "totals":
              [
              - {
                - "altLineId": 0,
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1,
                - "max": 0.1
                }
              ],
            - "teamTotal":
              {
              - "home":
                [
                - {
                  - "altLineId": null,
                  - "points": null,
                  - "over": null,
                  - "under": null,
                  - "max": null
                  }
                ],
              - "away":
                [
                - {
                  - "altLineId": null,
                  - "points": null,
                  - "over": null,
                  - "under": null,
                  - "max": null
                  }
                ]
              },
            - "awayScore": 0.1,
            - "homeScore": 0.1,
            - "awayRedCards": 0,
            - "homeRedCards": 0
            }
          ]
        }
      ]
    }
  ]

}`

## 获取串关赔率 - v3 Deprecated

返回所有未结算赛事的串关赔率。请注意，赛事可能出现在 Get Fixtures 响应中，但不在 Get Odds 中。这种情况发生在赔率目前不可用于投注时。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索赔率的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
oddsFormat | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。默认为 American。[American, Decimal, HongKong, Indonesian, Malay]
since | integer <int64> 用于接收增量更新。使用上次 odds 响应中的 last 值。如果不提供 since 参数，赔率最多会延迟 1 分钟，以鼓励使用该参数。请注意，使用 since 参数时，响应中只包含已更改的周期。如果某个周期没有任何更改，它将不会出现在响应中。
isLive | boolean 要仅检索直播赔率，请将值设置为 1 (isLive=1)。否则响应将包含所有赔率。
eventIds | Array of integers <int64> [ items <int64 > ] 按 EventIds 过滤

### Responses

https://api.pinnacle888.com/v3/odds/parlay

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "events":
      [
      - {
        - "id": 0,
        - "awayScore": 0.1,
        - "homeScore": 0.1,
        - "awayRedCards": 0,
        - "homeRedCards": 0,
        - "periods":
          [
          - {
            - "lineId": 0,
            - "number": 0,
            - "cutoff": "2019-08-24T14:15:22Z",
            - "status": 1,
            - "maxSpread": 0.1,
            - "maxMoneyline": 0.1,
            - "maxTotal": 0.1,
            - "maxTeamTotal": 0.1,
            - "moneylineUpdatedAt": 0.1,
            - "spreadUpdatedAt": 0.1,
            - "totalUpdatedAt": 0.1,
            - "teamTotalUpdatedAt": 0.1,
            - "spreads":
              [
              - {
                - "altLineId": 0,
                - "hdp": 0.1,
                - "home": 0.1,
                - "away": 0.1,
                - "max": 0.1
                }
              ],
            - "moneyline":
              {
              - "home": 0.1,
              - "away": 0.1,
              - "draw": 0.1
              },
            - "totals":
              [
              - {
                - "altLineId": 0,
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1,
                - "max": 0.1
                }
              ],
            - "teamTotal":
              {
              - "away":
                {
                - "altLineId": 0,
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1,
                - "max": 0.1
                },
              - "home":
                {
                - "altLineId": 0,
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1,
                - "max": 0.1
                }
              },
            - "awayScore": 0.1,
            - "homeScore": 0.1,
            - "awayRedCards": 0.1,
            - "homeRedCards": 0.1
            }
          ]
        }
      ]
    }
  ]

}`

## 获取串关赔率 - v4

返回所有未结算赛事的串关赔率。请注意，赛事可能出现在 Get Fixtures 响应中，但不在 Get Odds 中。这种情况发生在赔率目前不可用于投注时。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | integer <int32> 要检索赔率的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
oddsFormat | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。默认为 American。[American, Decimal, HongKong, Indonesian, Malay]
since | integer <int64> 用于接收增量更新。使用上次 odds 响应中的 last 值。如果不提供 since 参数，赔率最多会延迟 1 分钟，以鼓励使用该参数。请注意，使用 since 参数时，响应中只包含已更改的周期。如果某个周期没有任何更改，它将不会出现在响应中。
isLive | boolean 要仅检索直播赔率，请将值设置为 1 (isLive=1)。否则响应将包含所有赔率。
eventIds | Array of integers <int64> [ items <int64 > ] 按 EventIds 过滤

### Responses

https://api.pinnacle888.com/v4/odds/parlay

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 0,
- "last": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "events":
      [
      - {
        - "id": 0,
        - "awayScore": 0.1,
        - "homeScore": 0.1,
        - "awayRedCards": 0,
        - "homeRedCards": 0,
        - "periods":
          [
          - {
            - "lineId": 0,
            - "number": 0,
            - "cutoff": "2019-08-24T14:15:22Z",
            - "status": 1,
            - "maxSpread": 0.1,
            - "maxMoneyline": 0.1,
            - "maxTotal": 0.1,
            - "maxTeamTotal": 0.1,
            - "moneylineUpdatedAt": 0.1,
            - "spreadUpdatedAt": 0.1,
            - "totalUpdatedAt": 0.1,
            - "teamTotalUpdatedAt": 0.1,
            - "spreads":
              [
              - {
                - "altLineId": 0,
                - "hdp": 0.1,
                - "home": 0.1,
                - "away": 0.1,
                - "max": 0.1
                }
              ],
            - "moneyline":
              {
              - "home": 0.1,
              - "away": 0.1,
              - "draw": 0.1
              },
            - "totals":
              [
              - {
                - "altLineId": 0,
                - "points": 0.1,
                - "over": 0.1,
                - "under": 0.1,
                - "max": 0.1
                }
              ],
            - "teamTotal":
              {
              - "away":
                [
                - {
                  - "altLineId": null,
                  - "points": null,
                  - "over": null,
                  - "under": null,
                  - "max": null
                  }
                ],
              - "home":
                [
                - {
                  - "altLineId": null,
                  - "points": null,
                  - "over": null,
                  - "under": null,
                  - "max": null
                  }
                ]
              },
            - "awayScore": 0.1,
            - "homeScore": 0.1,
            - "awayRedCards": 0.1,
            - "homeRedCards": 0.1
            }
          ]
        }
      ]
    }
  ]

}`

## 获取过关赔率 - v1

返回指定过关的赔率。

##### Authorizations:

basicAuth

##### query Parameters

teaserId required | integer <int64> 唯一标识符。可以从 Get Teaser Groups 端点调用中检索过关详情。

### Responses

https://api.pinnacle888.com/v1/odds/teaser

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "teaserId": 0,
- "sportId": 0,
- "leagues":
  [
  - {
    - "id": 0,
    - "events":
      [
      - {
        - "id": 0,
        - "periods":
          [
          - {
            - "number": 0,
            - "lineId": 0,
            - "spreadUpdatedAt": "2019-08-24T14:15:22Z",
            - "totalUpdatedAt": "2019-08-24T14:15:22Z",
            - "spread":
              {
              - "maxBet": 0.1,
              - "homeHdp": 0.1,
              - "awayHdp": 0.1,
              - "altHdp": false
              },
            - "total":
              {
              - "maxBet": 0.1,
              - "overPoints": 0.1,
              - "underPoints": 0.1
              }
            }
          ]
        }
      ]
    }
  ]

}`

## 获取特殊赔率 - v2

返回所有未结算赛事的特殊赔率。

##### Authorizations:

basicAuth

##### query Parameters

oddsFormat | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。[American, Decimal, HongKong, Indonesian, Malay]
sportId required | integer <int32> 要检索特殊赛事的运动 ID。
leagueIds | Array of integers <int32> [ items <int32 > ] leagueIds 数组可包含逗号分隔的联赛 ID 列表。
since | integer <int64> 用于接收增量更新。使用上次响应中的 last 值。如果不提供 since 参数，赛程最多会延迟 1 分钟，以鼓励使用该参数。
specialId | integer <int64> 特殊赛事的 ID。这是可选参数。

### Responses

https://api.pinnacle888.com/v2/odds/special

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "sportId": 4,
- "last": 636433059510590700,
- "leagues":
  [
  - {
    - "id": 487,
    - "specials":
      [
      - {
        - "id": 1,
        - "maxBet": 100,
        - "contestantLines":
          [
          - {
            - "id": 1,
            - "lineId": 1001,
            - "price": -199,
            - "handicap": null,
            - "max": 100
            },
          - {
            - "id": 2,
            - "lineId": 1002,
            - "price": -198,
            - "handicap": null,
            - "max": 100
            }
          ]
        },
      - {
        - "id": 7,
        - "maxBet": 100,
        - "contestantLines":
          [
          - {
            - "id": 13,
            - "lineId": 1013,
            - "price": -187,
            - "handicap": null,
            - "max": 100
            },
          - {
            - "id": 14,
            - "lineId": 1014,
            - "price": -186,
            - "handicap": null,
            - "max": 100
            }
          ]
        }
      ]
    },
  - {
    - "id": 578,
    - "specials":
      [
      - {
        - "id": 10,
        - "maxBet": 100,
        - "contestantLines":
          [
          - {
            - "id": 21,
            - "lineId": 1021,
            - "price": -179,
            - "handicap": null,
            - "max": 100
            },
          - {
            - "id": 22,
            - "lineId": 1022,
            - "price": -178,
            - "handicap": null,
            - "max": 100
            },
          - {
            - "id": 23,
            - "lineId": 1023,
            - "price": -177,
            - "handicap": null,
            - "max": 100
            },
          - {
            - "id": 24,
            - "lineId": 1024,
            - "price": -176,
            - "handicap": null,
            - "max": 100
            }
          ]
        }
      ]
    }
  ]

}`

## Line

## 获取直盘线 - v2

返回最新线。

##### Authorizations:

basicAuth

##### query Parameters

leagueId required | integer <int32> 联赛 ID。
handicap required | number <double> SPREAD、TOTAL_POINTS 和 TEAM_TOTAL_POINTS 投注类型需要此参数
oddsFormat required | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。默认为 American。
sportId required | integer <int32> 运动标识
eventId required | integer <int64> 赛事标识
periodNumber required | integer <int32> 这代表比赛的周期。请查看 Get Periods 端点以获取每个运动当前支持的周期列表。
betType required | string Enum: "SPREAD" "MONEYLINE" "TOTAL_POINTS" "TEAM_TOTAL_POINTS" 投注类型
team | string Enum: "Team1" "Team2" "Draw" 选择的队伍类型。仅 SPREAD、MONEYLINE 和 TEAM_TOTAL_POINTS 投注类型需要此参数
side | string Enum: "OVER" "UNDER" 选择的侧。仅 TOTAL_POINTS 和 TEAM_TOTAL_POINTS 需要此参数

### Responses

https://api.pinnacle888.com/v2/line

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "status": "SUCCESS",
- "price": 0.1,
- "lineId": 0,
- "altLineId": 0,
- "team1Score": 0,
- "team2Score": 0,
- "team1RedCards": 0,
- "team2RedCards": 0,
- "maxRiskStake": 0.1,
- "minRiskStake": 0.1,
- "maxWinStake": 0.1,
- "minWinStake": 0.1,
- "effectiveAsOf": "string",
- "periodTeam1Score": 0,
- "periodTeam2Score": 0,
- "periodTeam1RedCards": 0,
- "periodTeam2RedCards": 0

}`

## 获取串关线 - v3

返回串关线并计算赔率。

##### Authorizations:

basicAuth

##### Request Body schema: application/json
required

oddsFormat | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 响应中的赔率将采用此格式。[American, Decimal, HongKong, Indonesian, Malay]
| Array of objects (ParlayLineRequestV3) 这是腿的集合

### Responses

https://api.pinnacle888.com/v3/line/parlay

### Request samples

- Payload

Content type
application/json
`
{

- "oddsFormat": "American",
- "legs":
  [
  - {
    - "uniqueLegId": "string",
    - "eventId": 0,
    - "periodNumber": 0,
    - "legBetType": "SPREAD",
    - "team": "Team1",
    - "side": "OVER",
    - "handicap": 0.1
    }
  ]

}`

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "status": "PROCESSED_WITH_ERROR",
- "error": "INVALID_LEGS",
- "minRiskStake": 0.1,
- "maxParlayRiskStake": 0.1,
- "maxRoundRobinTotalRisk": 0.1,
- "maxRoundRobinTotalWin": 0.1,
- "roundRobinOptionWithOdds":
  [
  - {
    - "roundRobinOption": "Parlay",
    - "odds": 0.1,
    - "unroundedDecimalOdds": 0.1,
    - "numberOfBets": 0
    }
  ],
- "legs":
  [
  - {
    - "status": "VALID",
    - "errorCode": "CORRELATED",
    - "legId": "string",
    - "lineId": 0,
    - "altLineId": 0,
    - "price": 0.1,
    - "correlatedLegs":
      [
      - "string"
      ]
    }
  ]

}`

## 获取过关线 - v1

在提交前验证过关投注。成功时返回投注限额和价格。

##### Authorizations:

basicAuth

##### Request Body schema: application/json
required

teaserId required | integer <int64> 唯一标识符。可以从调用 v1/teaser/groups 端点检索过关详情。
oddsFormat required | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。[American, Decimal, HongKong, Indonesian, Malay]
required | Array of objects (TeaserLineRequest) 过关腿的集合。

### Responses

https://api.pinnacle888.com/v1/line/teaser

### Request samples

- Payload

Content type
application/json
`
{

- "teaserId": 0,
- "oddsFormat": "American",
- "legs":
  [
  - {
    - "legId": "string",
    - "eventId": 0,
    - "periodNumber": 0,
    - "betType": "SPREAD",
    - "team": "Team1",
    - "side": "OVER",
    - "handicap": 0.1
    }
  ]

}`

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "status": "PROCESSED_WITH_ERROR",
- "errorCode": "INVALID_LEGS",
- "price": 0.1,
- "minRiskStake": 0.1,
- "maxRiskStake": 0.1,
- "minWinStake": 0.1,
- "maxWinStake": 0.1,
- "legs":
  [
  - {
    - "status": "PROCESSED_WITH_ERROR",
    - "errorCode": "EVENT_NOT_FOUND",
    - "legId": "string",
    - "lineId": 0
    }
  ]

}`

## 获取特殊线 - v2

返回特殊线并计算赔率。

##### Authorizations:

basicAuth

##### query Parameters

oddsFormat required | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。[American, Decimal, HongKong, Indonesian, Malay]
specialId required | integer <int64> 特殊赛事的 ID。
contestantId required | integer <int64> 参赛者 ID。
handicap | number <double> 参赛者的让分。由于参赛者的让分是一个可变属性，可能会发生 line/special 返回 status:SUCCESS，但让分与客户端在调用 line/special 时拥有的让分不同。可以在请求中指定 handicap 参数，如果参赛者的让分已更改，它将返回 status:NOT_EXISTS。这样 line/special 与 /line 的工作方式更加一致。

### Responses

https://api.pinnacle888.com/v2/line/special

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "status": "SUCCESS",
- "specialId": 0,
- "contestantId": 0,
- "minRiskStake": 0.1,
- "maxRiskStake": 0.1,
- "minWinStake": 0.1,
- "maxWinStake": 0.1,
- "lineId": 0,
- "price": 0.1,
- "handicap": 0.1

}`

## Others

## 获取运动项目 - v3

返回所有运动项目及其当前是否有线的状态。

##### Authorizations:

basicAuth

### Responses

https://api.pinnacle888.com/v3/sports

### Response samples

- 200
- 401
- 403
- 500

Content type
application/json
`
{

- "sports":
  [
  - {
    - "id": 0,
    - "name": "string",
    - "hasOfferings": true,
    - "leagueSpecialsCount": 0,
    - "eventSpecialsCount": 0,
    - "eventCount": 0
    }
  ]

}`

## 获取联赛 - v3

返回所有体育联赛及其当前是否有线的状态。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | string 请求联赛的运动 ID。

### Responses

https://api.pinnacle888.com/v3/leagues

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "leagues":
  [
  - {
    - "id": 0,
    - "name": "string",
    - "homeTeamType": "string",
    - "hasOfferings": true,
    - "container": "string",
    - "allowRoundRobins": true,
    - "leagueSpecialsCount": 0,
    - "eventSpecialsCount": 0,
    - "eventCount": 0
    }
  ]

}`

## 获取周期 - v1

返回指定运动的所有周期。

##### Authorizations:

basicAuth

##### query Parameters

sportId required | string

### Responses

https://api.pinnacle888.com/v1/periods

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "periods":
  [
  - {
    - "number": 0,
    - "description": "全场",
    - "shortDescription": "FT"
    },
  - {
    - "number": 1,
    - "description": "上半场",
    - "shortDescription": "1st H"
    },
  - {
    - "number": 2,
    - "description": "下半场",
    - "shortDescription": "2nd H"
    }
  ]

}`

## 获取进行中赛事 - v2

返回所有状态显示为正在进行中的直播足球赛事。

##### Authorizations:

basicAuth

### Responses

https://api.pinnacle888.com/v2/inrunning

### Response samples

- 200
- 401
- 403
- 500

Content type
application/json
`
{

- "sports":
  [
  - {
    - "id": 0,
    - "leagues":
      [
      - {
        - "id": 0,
        - "events":
          [
          - {
            - "id": 0,
            - "state": 1,
            - "elapsed": 0
            }
          ]
        }
      ]
    }
  ]

}`

## 获取过关组 - v1

返回所有过关组。

##### Authorizations:

basicAuth

##### query Parameters

oddsFormat required | string Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay" 返回赔率的格式。[American, Decimal, HongKong, Indonesian, Malay]

### Responses

https://api.pinnacle888.com/v1/teaser/groups

### Response samples

- 200
- 400
- 401
- 403
- 500

Content type
application/json
`
{

- "teaserGroups":
  [
  - {
    - "id": 0,
    - "name": "string",
    - "teasers":
      [
      - {
        - "id": 0,
        - "description": "string",
        - "sportId": 0,
        - "minLegs": 0,
        - "maxLegs": 0,
        - "sameEventOnly": true,
        - "payouts":
          [
          - {
            - "numberOfLegs": 0,
            - "price": 0.1
            }
          ],
        - "leagues":
          [
          - {
            - "id": 0,
            - "spread":
              {
              - "points": 0.1
              },
            - "total":
              {
              - "points": 0.1
              }
            }
          ]
        }
      ]
    }
  ]

}`

## 获取取消原因 - v1

查找所有取消原因

##### Authorizations:

basicAuth

### Responses

https://api.pinnacle888.com/v1/cancellationreasons

### Response samples

- 200
- 401
- 403
- 500

Content type
application/json
`
{

- "cancellationReasons":
  [
  - {
    - "code": "FBS_CW_65",
    - "description": "The event was postponed"
    }
  ]

}`

## 获取货币 - v2

返回支持的货币列表

##### Authorizations:

basicAuth

### Responses

https://api.pinnacle888.com/v2/currencies

### Response samples

- 200
- 401
- 403
- 500

Content type
application/json
`
{

- "currencies":
  [
  - {
    - "code": "AED",
    - "name": "United Arab Emirates Dirham",
    - "rate": 3.6738
    }
  ]

}`