Skip to main content

Mobile data session sums for the gateway

GET 
/gateways/:address/mobile/data/sum

Returns aggregated mobile data transfer session totals for the requested window.

By default, this endpoint uses precomputed summaries because that is much faster and cheaper for repeated customer queries. source=summary is the recommended mode for dashboards, historical ranges, and most customer-facing views.

Live mobile data transfer reports are bucketed by report timestamp, but those reports can arrive late. This happens in normal pipeline delay cases, and also when a hotspot keeps carrying traffic while it is unable to report usage, then flushes older reports after it recovers. Summary mode replays a bounded late-arrival window to absorb many of those cases, currently about 16 hours for hourly requests and 72 hours for day-or-broader requests.

If you need the freshest event-time totals for a recent window, set source=raw. Raw mode recomputes the result directly from the underlying live mobile data transfer reports using report timestamp. It is slower, but it can capture delayed reports that have not yet been folded into the summary path.

For payment or payout reconciliation, use /gateways/{address}/mobile/rewards/sum instead. That endpoint reflects the reward amounts that the Oracles actually attributed to the gateway in the requested period, while this endpoint reports live usage totals and reward-eligible traffic.

If you need the rewarded data-byte values on individual Oracle reward records, use /gateways/{address}/mobile/rewards and inspect gatewayRewardParms.rewardableBytes. In other words: use this endpoint for live usage analysis, /mobile/rewards/sum for payout amounts, and /mobile/rewards when you need reward-record detail.

Request​

Responses​

List of MobileValidDataTransferSessionSum.