Skip to main content

Mobile reward sums for the gateway

GET 
/gateways/:address/mobile/rewards/sum

Returns summed mobile rewards for the specified window, optionally bucketed by time.

Use this endpoint for payment or payout reconciliation. It reflects the reward amounts that the Oracles actually attributed to the gateway for the requested period.

This is different from /gateways/{address}/mobile/data/sum, which reports live mobile usage totals and reward-eligible traffic based on report timing rather than finalized reward attribution.

HNT rows also include the gateway's realized USD-per-GB rate. The server calculates it as a byte-weighted value across the requested bucket, which can blend more than one HIP-150 multiplier. It is not a standalone 1x rate. Optional hntPriceUsd is the historical USD/HNT price weighted by data-reward tokens in the bucket, excluding PoC. It is omitted without HNT data rewards or when any positive HNT gateway data reward cannot be valued reliably.

Bucketed responses include zero totals for missing UTC buckets, newest first. Only entirely missing buckets receive a zero row, using the preceding recorded token unit (the earliest unit for leading gaps, HNT for an empty history). Real mixed-token buckets are preserved with HNT first; after a migration bucket containing both tokens, gaps use HNT. Zero rows omit prices and earnings rates. Unbucketed aggregates retain their existing behavior. Ranges may contain at most 100,000 buckets; the upper bound is exclusive.

Request​

Responses​

List of GatewayMobileRewardSum.