...
Statistics Platform delivers Live Match Statistics to any interested customer via Ably. The Statistics are being generated from Match State Events, based on rules configuration.
...
V2 Documentation and Swagger: https://statistics.api.geniussports.com/docs/openapi
Delivery
Statistics are being delivered through Ably. You can find the Ably integration guide here.
Consumers should subscribe to Fixture and Source specific channel. Channel names follow the pattern
"live-statistics:{sportName}:{versionNumber}:{fixtureId}:{sourceId}"(e.g."live-statistics:AmericanFootball:v1:456789:GeniusPremium"). All consumers that have a token for that channel will receive Live Match Statistics via that channel.Currently V1 is not available on UAT, but V2 is available on both environments.
Contract
JSON Schema
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
...
| Code Block | ||
|---|---|---|
| ||
{
"version": "1.0.0",
"generatedFromEvent": "125367489-45678-3246587-1357"
"updatedAtUtc": "2021-05-26T09:41:20Z",
"heartbeatExpiresAtUtc": "2021-05-26T09:41:30Z",
} |
version | string | The version of the Statistics Contract. |
generatedFromEvent | string - UUID | The UUID of the last event in Match State that affected the statistics. |
updatedAtUtc | ISO 8601 timestamp | The timestamp when the statistics were updated. |
heartbeatExpiresAtUtc | ISO 8601 timestamp | The timestamp by when you should expect another message. |
source
The sourcesection contains information about the source, that is providing Match Events.
| Code Block | ||
|---|---|---|
| ||
{
"id": 56,
"name": "LiveStats",
"version": "123.456.756",
"href": "coverages.api.geniussports.com/v1/sources/56",
} |
id | int | The id of the Match Events Source |
name | string | The name of the Match Events Source |
version | string | The version of the Match Events Source |
href | string - url | The link to the Match Events Source details |
fixture
The fixturesection contains minimal information about the Match.
| Code Block | ||
|---|---|---|
| ||
{
"id": 999999
"href": "fixtures.api.geniussports.com/v1/fixtures/999999"
} |
id | int | The id of the Fixture |
href | string - url | The link to the Fixture details |
competitors
The competitorsarray contains competitor objects, that contain minimal information about the competitors within the match, a list of competitor participants, and competitor statistics.
...
| Code Block | ||
|---|---|---|
| ||
{
"id": 1,
"href": "fixtures.api.geniussports.com/v1/competitors/1",
"statistics": {},
"participants": [{}],
} |
id | int | The id of the Competitor |
href | string - url | The link to the Competitor details |
statistics | object | The statistics object for the Competitor |
participants
The participantsarray contains participant objects, that contain minimal information about the participant in a competitor and participant statistics.
...
| Code Block | ||
|---|---|---|
| ||
{
"id": 123456,
"href": "fixtures.api.geniussports.com/v1/players/123456",
"statistics": {},
} |
id | int | The id of the Participant |
href | string - url | The link to the Participant details |
statistics | object | The statistics object for the Participant |
statistics
The statistics object contains the list of statistics for the entity that it is presented in.
...
You can use the Statistics API Swagger to try out the calls and investigate the schema files.