Indexer: Stargate token rewards
getStargateTokenRewardsRetrieve accrued reward overviews for a Stargate NFT delegation to a validator, aggregated by cycle, day, week, month, year, or all. Optionally filter by validator and paginate through results.
Instructions
Overview of rewards earned by a Stargate NFT delegation to a validator over time. Not the same as “claimed” (claimable only at end of cycle). Supports periodType (CYCLE, DAY, WEEK, MONTH, YEAR, ALL), optional validator, and pagination.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tokenId": "<tokenId>",
"periodType": "<periodType>"
},
"name": "getStargateTokenRewards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Zero-based results page number (0 is the first page) | |
| size | No | Results per page (1..150); API default is typically 20 | |
| cursor | No | Opaque cursor for fetching the next page when provided by the API | |
| tokenId | Yes | The numeric Stargate NFT token ID (e.g. "12345"), NOT the level name. Use getStargateTokens to find token IDs for a given owner. | |
| direction | No | Sort direction for time-based queries; defaults to 'DESC' (newest first) | |
| validator | No | Optional validator address filter | |
| periodType | Yes | Reward period to aggregate by (CYCLE, DAY, WEEK, MONTH, YEAR, ALL) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| network | Yes |