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

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "league": [
    ]
}

获取特殊赛程 - 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

Response samples

Content type
application/json
{
  • "sportId": 4,
  • "last": 636433059508250600,
  • "leagues": [
    ]
}

获取已结算赛程 - 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

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "leagues": [
    ]
}

获取已结算特殊赛程 - v3

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

Authorizations:
basicAuth
query Parameters
sportId
required
integer <int32>

要检索已结算特殊赛事的运动 ID。

leagueIds
Array of integers <int32> [ items <int32 > ]

leagueIds 数组。这是可选参数。

since
integer <int64>

用于接收增量更新。使用上次响应中的 last 字段值。

Responses

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "leagues": [
    ]
}

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

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "leagues": [
    ]
}

获取直盘赔率 - 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

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "leagues": [
    ]
}

获取串关赔率 - 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

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "leagues": [
    ]
}

获取串关赔率 - 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

Response samples

Content type
application/json
{
  • "sportId": 0,
  • "last": 0,
  • "leagues": [
    ]
}

获取过关赔率 - v1

返回指定过关的赔率。

Authorizations:
basicAuth
query Parameters
teaserId
required
integer <int64>

唯一标识符。可以从 Get Teaser Groups 端点调用中检索过关详情。

Responses

Response samples

Content type
application/json
{
  • "teaserId": 0,
  • "sportId": 0,
  • "leagues": [
    ]
}

获取特殊赔率 - 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

Response samples

Content type
application/json
{
  • "sportId": 4,
  • "last": 636433059510590700,
  • "leagues": [
    ]
}

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

Response samples

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

Request samples

Content type
application/json
{
  • "oddsFormat": "American",
  • "legs": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "PROCESSED_WITH_ERROR",
  • "error": "INVALID_LEGS",
  • "minRiskStake": 0.1,
  • "maxParlayRiskStake": 0.1,
  • "maxRoundRobinTotalRisk": 0.1,
  • "maxRoundRobinTotalWin": 0.1,
  • "roundRobinOptionWithOdds": [
    ],
  • "legs": [
    ]
}

获取过关线 - 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

Request samples

Content type
application/json
{
  • "teaserId": 0,
  • "oddsFormat": "American",
  • "legs": [
    ]
}

Response samples

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": [
    ]
}

获取特殊线 - 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

Response samples

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

Response samples

Content type
application/json
{
  • "sports": [
    ]
}

获取联赛 - v3

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

Authorizations:
basicAuth
query Parameters
sportId
required
string

请求联赛的运动 ID。

Responses

Response samples

Content type
application/json
{
  • "leagues": [
    ]
}

获取周期 - v1

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

Authorizations:
basicAuth
query Parameters
sportId
required
string

Responses

Response samples

Content type
application/json
{
  • "periods": [
    ]
}

获取进行中赛事 - v2

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

Authorizations:
basicAuth

Responses

Response samples

Content type
application/json
{
  • "sports": [
    ]
}

获取过关组 - v1

返回所有过关组。

Authorizations:
basicAuth
query Parameters
oddsFormat
required
string
Enum: "American" "Decimal" "HongKong" "Indonesian" "Malay"

返回赔率的格式。[American, Decimal, HongKong, Indonesian, Malay]

Responses

Response samples

Content type
application/json
{
  • "teaserGroups": [
    ]
}

获取取消原因 - v1

查找所有取消原因

Authorizations:
basicAuth

Responses

Response samples

Content type
application/json
{
  • "cancellationReasons": [
    ]
}

获取货币 - v2

返回支持的货币列表

Authorizations:
basicAuth

Responses

Response samples

Content type
application/json
{
  • "currencies": [
    ]
}