Skip to main content

FixturesService

A list of all methods in the FixturesService service. Click on the method name to view detailed information about that method.

MethodsDescription
fixtures_v1_getReturns all non-settled events for the given sport. Please note that it is possible that the event is in Get Fixtures response but not in Get Odds. This happens when the odds are not currently available for wagering. Please note that it is possible to receive the same exact response when using since parameter. This is rare and can be caused by internal updates of event properties.
fixtures_special_v1_getReturns all non-settled specials for the given sport.
fixtures_settled_v1_getReturns fixtures settled in the last 24 hours for the given sport.
fixtures_specials_settled_v1_getReturns all specials which are settled in the last 24 hours for the given Sport.

fixtures_v1_get

Returns all non-settled events for the given sport. Please note that it is possible that the event is in Get Fixtures response but not in Get Odds. This happens when the odds are not currently available for wagering. Please note that it is possible to receive the same exact response when using since parameter. This is rare and can be caused by internal updates of event properties.

  • HTTP Method: GET
  • Endpoint: /v1/fixtures

Parameters

NameTypeRequiredDescription
sport_idintThe sport id to retrieve the fixtures for.
league_idsList[int]The leagueIds array may contain a list of comma separated league ids.
is_liveboolTo retrieve ONLY live events set the value to 1 (isLive=1). Missing or any other value will result in retrieval of events regardless of their Live status.
sinceintThis is used to receive incremental updates. Use the value of last from previous fixtures response. When since parameter is not provided, the fixtures are delayed up to 1 minute to encourage the use of the parameter.
event_idsList[int]Comma separated list of event ids to filter by

Return Type

FixturesResponse

Example Usage Code Snippet

from pinnacle_link import PinnacleLink, Environment

sdk = PinnacleLink(
username="YOUR_USERNAME",
password="YOUR_PASSWORD",
base_url=Environment.DEFAULT.value
)
league_ids=[
3
]
event_ids=[
3
]

result = sdk.fixtures.fixtures_v1_get(
sport_id=6,
league_ids=league_ids,
is_live=True,
since=9,
event_ids=event_ids
)

print(result)

fixtures_special_v1_get

Returns all non-settled specials for the given sport.

  • HTTP Method: GET
  • Endpoint: /v1/fixtures/special

Parameters

NameTypeRequiredDescription
sport_idintId of a sport for which to retrieve the specials.
league_idsList[int]The leagueIds array may contain a list of comma separated league ids.
sinceintThis is used to receive incremental updates. Use the value of last field from the previous response. When since parameter is not provided, the fixtures are delayed up to 1 min to encourage the use of the parameter.
categorystrThe category the special falls under.
event_idintId of an event associated with a special.
special_idintId of the special.

Return Type

SpecialsFixturesResponse

Example Usage Code Snippet

from pinnacle_link import PinnacleLink, Environment

sdk = PinnacleLink(
username="YOUR_USERNAME",
password="YOUR_PASSWORD",
base_url=Environment.DEFAULT.value
)
league_ids=[
8
]

result = sdk.fixtures.fixtures_special_v1_get(
sport_id=8,
league_ids=league_ids,
since=1,
category="category",
event_id=0,
special_id=0
)

print(result)

fixtures_settled_v1_get

Returns fixtures settled in the last 24 hours for the given sport.

  • HTTP Method: GET
  • Endpoint: /v1/fixtures/settled

Parameters

NameTypeRequiredDescription
sport_idint
league_idsList[int]
sinceint

Return Type

SettledFixturesSport

Example Usage Code Snippet

from pinnacle_link import PinnacleLink, Environment

sdk = PinnacleLink(
username="YOUR_USERNAME",
password="YOUR_PASSWORD",
base_url=Environment.DEFAULT.value
)
league_ids=[
1
]

result = sdk.fixtures.fixtures_settled_v1_get(
sport_id=1,
league_ids=league_ids,
since=0
)

print(result)

fixtures_specials_settled_v1_get

Returns all specials which are settled in the last 24 hours for the given Sport.

  • HTTP Method: GET
  • Endpoint: /v1/fixtures/special/settled

Parameters

NameTypeRequiredDescription
sport_idintId of the sport for which to retrieve the settled specials.
league_idsList[int]Array of leagueIds. This is optional parameter.
sinceintThis is used to receive incremental updates. Use the value of last from previous response.

Return Type

SettledSpecialsResponse

Example Usage Code Snippet

from pinnacle_link import PinnacleLink, Environment

sdk = PinnacleLink(
username="YOUR_USERNAME",
password="YOUR_PASSWORD",
base_url=Environment.DEFAULT.value
)
league_ids=[
8
]

result = sdk.fixtures.fixtures_specials_settled_v1_get(
sport_id=3,
league_ids=league_ids,
since=5
)

print(result)

Build Your Own SDKs with  liblab

Build developer friendly SDKs in minutes from your APIs

Start for Free →