List games
GET/api/v2/games
Get a list of games and corresponding game data, given the provided filters
Request
Query Parameters
- ENTITY_SCOPE_INDIVIDUALS: Rewards must be distributed directly to eligible parties.
- ENTITY_SCOPE_TEAMS: Rewards must be distributed to directly eligible teams, and then amongst team members
Game ID to filter for.
Oldest epoch to retrieve game data from, inclusive. The maximum range of epochs that can be fetched at once is 30. If not provided, defaults to the 'to' epoch minus 29, or the first epoch available if not enough epochs have passed. If the 'to' epoch is not specified, it will be set to the chosen 'from' epoch + 29.
Most recent epoch to retrieve game data to, inclusive. If not provided, defaults to the latest epoch. The maximum range of epochs that can be fetched at once is 30. If no 'from' epoch is provided, or the 'from' epoch is out of range, i.e., the 'to' epoch - 'from' epoch > 29, the 'from' epoch will be set to the 'to' epoch - 29.
Possible values: [ENTITY_SCOPE_UNSPECIFIED
, ENTITY_SCOPE_INDIVIDUALS
, ENTITY_SCOPE_TEAMS
]
Default value: ENTITY_SCOPE_UNSPECIFIED
Entity scope to filter games for, i.e. team games or individual games only.
Number of records to be returned that sort greater than row identified by cursor supplied in 'after'.
If paging forwards, the cursor string for the last row of the previous page.
Number of records to be returned that sort less than row identified by cursor supplied in 'before'.
If paging forwards, the cursor string for the first row of the previous page.
Whether to order the results with the newest records first. If not set, the default value is true.
Team ID to filter for. This filter will only be applied if entity scope is not specified in the request, or the entity scope is set to teams.
Party ID to filter for. This filter will apply regardless of the entity scope. If the entity scope filter is teams, then the party ID filter will apply to team members.
Responses
- 200
- 500
- default
A successful response.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- Array [
- ]
- Array [
- Array [
- ]
- ]
- ]
games object
Page of games data and corresponding page information.
edges object[]
Page of games data and their corresponding cursors.
Cursor that can be used to fetch further pages.
node object
Game data.
Epoch at which the last game metrics were captured.
individual object
individual object[]
List of individual party IDs, and the metrics associated with each participant.
Rank of the individual either in the game or within their team.
Possible values: [DISPATCH_METRIC_UNSPECIFIED
, DISPATCH_METRIC_MAKER_FEES_PAID
, DISPATCH_METRIC_MAKER_FEES_RECEIVED
, DISPATCH_METRIC_LP_FEES_RECEIVED
, DISPATCH_METRIC_MARKET_VALUE
, DISPATCH_METRIC_AVERAGE_POSITION
, DISPATCH_METRIC_RELATIVE_RETURN
, DISPATCH_METRIC_RETURN_VOLATILITY
, DISPATCH_METRIC_VALIDATOR_RANKING
, DISPATCH_METRIC_REALISED_RETURN
]
Default value: DISPATCH_METRIC_UNSPECIFIED
The number of participants in the game.
ID of the asset rewarded for involvement in the game.
team object
team object[]
List of teams, the participant members of a team, and the metrics associated with each participant.
Possible values: [DISPATCH_METRIC_UNSPECIFIED
, DISPATCH_METRIC_MAKER_FEES_PAID
, DISPATCH_METRIC_MAKER_FEES_RECEIVED
, DISPATCH_METRIC_LP_FEES_RECEIVED
, DISPATCH_METRIC_MARKET_VALUE
, DISPATCH_METRIC_AVERAGE_POSITION
, DISPATCH_METRIC_RELATIVE_RETURN
, DISPATCH_METRIC_RETURN_VOLATILITY
, DISPATCH_METRIC_VALIDATOR_RANKING
, DISPATCH_METRIC_REALISED_RETURN
]
Default value: DISPATCH_METRIC_UNSPECIFIED
team object
Breakdown of a team's participation in a game.
membersParticipating object[]
Rank of the individual either in the game or within their team.
Possible values: [DISPATCH_METRIC_UNSPECIFIED
, DISPATCH_METRIC_MAKER_FEES_PAID
, DISPATCH_METRIC_MAKER_FEES_RECEIVED
, DISPATCH_METRIC_LP_FEES_RECEIVED
, DISPATCH_METRIC_MARKET_VALUE
, DISPATCH_METRIC_AVERAGE_POSITION
, DISPATCH_METRIC_RELATIVE_RETURN
, DISPATCH_METRIC_RETURN_VOLATILITY
, DISPATCH_METRIC_VALIDATOR_RANKING
, DISPATCH_METRIC_REALISED_RETURN
]
Default value: DISPATCH_METRIC_UNSPECIFIED
pageInfo object
Page information that is used for fetching further pages.
End cursor.
Indicator if there is a next page.
Indicator if there is a previous page.
Start cursor.
{
"games": {
"edges": [
{
"cursor": "string",
"node": {
"epoch": "string",
"id": "string",
"individual": {
"individual": [
{
"individual": "string",
"rank": "string",
"rewardEarned": "string",
"rewardEarnedQuantum": "string",
"rewardMetric": "DISPATCH_METRIC_UNSPECIFIED",
"totalRewardsEarned": "string",
"totalRewardsEarnedQuantum": "string",
"volume": "string"
}
]
},
"participants": "string",
"rewardAssetId": "string",
"team": {
"team": [
{
"rank": "string",
"rewardEarned": "string",
"rewardEarnedQuantum": "string",
"rewardMetric": "DISPATCH_METRIC_UNSPECIFIED",
"team": {
"membersParticipating": [
{
"individual": "string",
"rank": "string",
"rewardEarned": "string",
"rewardEarnedQuantum": "string",
"rewardMetric": "DISPATCH_METRIC_UNSPECIFIED",
"totalRewardsEarned": "string",
"totalRewardsEarnedQuantum": "string",
"volume": "string"
}
],
"teamId": "string"
},
"totalRewardsEarned": "string",
"totalRewardsEarnedQuantum": "string",
"volume": "string"
}
]
}
}
}
],
"pageInfo": {
"endCursor": "string",
"hasNextPage": true,
"hasPreviousPage": true,
"startCursor": "string"
}
}
}
An internal server error
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- If no scheme is provided,
https
is assumed. - An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
- Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
- ]
details object[]
A URL/resource name that uniquely identifies the type of the serialized
protocol buffer message. This string must contain at least
one "/" character. The last segment of the URL's path must represent
the fully qualified name of the type (as in
path/google.protobuf.Duration
). The name should be in a canonical form
(e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they
expect it to use in the context of Any. However, for URLs which use the
scheme http
, https
, or no scheme, one can optionally set up a type
server that maps type URLs to message definitions as follows:
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.
Schemes other than http
, https
(or the empty scheme) might be
used with implementation specific semantics.
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
An unexpected error response.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- If no scheme is provided,
https
is assumed. - An HTTP GET on the URL must yield a [google.protobuf.Type][] value in binary format, or produce an error.
- Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)
- ]
details object[]
A URL/resource name that uniquely identifies the type of the serialized
protocol buffer message. This string must contain at least
one "/" character. The last segment of the URL's path must represent
the fully qualified name of the type (as in
path/google.protobuf.Duration
). The name should be in a canonical form
(e.g., leading "." is not accepted).
In practice, teams usually precompile into the binary all types that they
expect it to use in the context of Any. However, for URLs which use the
scheme http
, https
, or no scheme, one can optionally set up a type
server that maps type URLs to message definitions as follows:
Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com.
Schemes other than http
, https
(or the empty scheme) might be
used with implementation specific semantics.
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}