heliumtools.org

get-wallet-mobile-activity

Recent Mobile network activity for a wallet's Mobile Hotspots: data-transfer HNT per UTC day for the last 7 days published (with that day's HNT price and the rewarded bytes it paid for), users served on the latest usage day, ban status, and for WiFi indoor/outdoor Hotspots the heartbeats and rejected heartbeats in a 60-minute window (location trust, distance from the asserted location, reported positions) and the latest speedtest average in a 24-hour window. A window ends now while its data is fresh, otherwise at its last successful check (windows gives each end); null means unknown, never 0. Issues, most serious first: banned (latest ban record is a ban), then WiFi health signals that don't change data-transfer HNT: noHeartbeat (none in the heartbeat window), lowTrust (latest location trust below 1), lowSpeedtest (latest speedtest multiplier below 1), rejectedHeartbeats (any in the window). counts, rewards and usage cover every Mobile Hotspot (a count is null while its data isn't in). hotspots is paged: membership follows entityKey, so pages hold still between calls, and rows run most actionable first within a page; to triage across the fleet, pass issue (counts say how many have each). Use offset/limit and pagination.nextOffset (default 50, max 200); with issue set, the matching set follows live data and can change between calls. When the wallet is on screen, reads the dashboard's own data with no extra downloads (waiting up to 45 s for its first check), unless that tab is hidden and last checked over 5 minutes ago. Otherwise runs one check itself (up to 60 s, then returns what it has), reading Helium's public Mobile network data files whole: roughly 25 MB for a fleet of data-only Hotspots and 55 MB with WiFi Hotspots when this browser hasn't read them recently, and little once it has, since the files serve every wallet and share the dashboard's cache. Mobile Hotspots with ecc_compact keys (CBRS radios) aren't covered. For IoT Hotspots use get-wallet-iot-status.

Page: /wallet-dashboard

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]+$",
      "minLength": 32,
      "maxLength": 44,
      "description": "Solana wallet address (base58). Optional when the dashboard already shows a wallet — defaults to that one."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Start at this offset; use pagination.nextOffset for the next page."
    },
    "issue": {
      "type": "string",
      "enum": [
        "banned",
        "noHeartbeat",
        "lowTrust",
        "lowSpeedtest",
        "rejectedHeartbeats"
      ],
      "description": "List only Mobile Hotspots with this issue. counts still cover every Mobile Hotspot."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Maximum Hotspots on this page; rows run most actionable first within it."
    }
  },
  "additionalProperties": false
}