Rewards API Overview

We offer a standardized way to fetch rewards across all networks, with the following features:

Features

  • Consistent responses: Every network follows the same consistent response structure. You don't need to worry about networks specifics, we've done all the translation for you
  • Rewards and balances: We report rewards but also staked balances. Slashing and penalties are treated as negative rewards
  • Granular periods and rollups: All networks offer the most granular reporting periods (the rewards distribution frequency of the network): epoch SOL, era for DOT, etc. Except Cosmos and Ethereum, for which we report rewards daily
  • Flexible accounts levels: All networks offer the most granular account-level reporting (validator pubkey for ETH, stake account for SOL, etc) but also some rollups by higher-level accounts (withdrawal address for ETH, system account for SOL, etc)
  • Since genesis: We index and serve rewards since genesis for most chains (except Cosmos, only since 2023-03-15)
  • Low latency: Data is available within 3 hours of the end of the period (epoch, era or daily rollups). Daily rollups are all computed from a midnight UTC to the next (we don't rollup by timezone)

Summary

NetworkScopeAccountsTime AggregationsHistorical Depth
EthereumFigment OnlyValidator Public Key,
Withdrawal Address
Daily, all-timeNo Limit
Ethereum (net)Figment OnlyWithdrawal AddressReward eventNo Limit
SolanaFigment OnlyStake Account,
System Account
Epoch60d
PolkadotAll NetworkDelegator AccountEra, Dailyepoch: 30d
daily: No Limit
CardanoAll NetworkDelegator AccountEpochNo Limit
CosmosAll NetworkDelegator AccountDailyNo Limit
NEARAll NetworkDelegator AccountDailyNo Limit
PolygonFigment OnlyDelegator AccountCheckpointNo Limit
AvalancheFigment OnlyDelegator AccountStaking periodNo Limit
SuiFigment OnlyDelegator AccountSnapshotNo Limit
InjectiveFigment OnlyDelegator AccountSnapshotNo Limit

Did this page help you?