heliumtools.org

get-wallet-iot-status

Per-Hotspot IoT connectivity and 30-day delivered LoRaWAN messages for a wallet's IoT Hotspots. Connectivity is a per-UTC-day verdict (active = connected to the Helium Packet Router on the latest reported day), not online-now. Health combines the two: inactiveTraffic (not connected, but had messages in the window — check these first), activeQuiet (connected, no messages in 30 days), inactiveQuiet, activeTraffic. Page membership follows entityKey before health filtering, so pages hold still when the dashboard's scan finishes; rows run most actionable first within a page. To triage, pass health to list matching rows within each page. Pagination always counts all IoT Hotspots, including nonmatches: follow pagination.nextOffset even when hotspots is empty. Use offset/limit to retrieve all pages. Uses the dashboard's finished scan when that wallet is on screen (whole-fleet counts, same as the UI); otherwise looks up at most 200 IoT Hotspots per page. aggregateScope identifies whether counts/health/traffic cover the fleet (dashboard) or only this page (own scan). For one Hotspot's daily messages per OUI (operator), use get-iot-hotspot-traffic.

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."
    },
    "health": {
      "type": "string",
      "enum": [
        "inactiveTraffic",
        "activeQuiet",
        "inactiveQuiet",
        "activeTraffic"
      ],
      "description": "List only rows in this health state within each entityKey page. Pagination still counts every IoT Hotspot; continue with nextOffset even when no rows match. counts and health cover the whole fleet with dashboard data, or the scanned page otherwise."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Start at this offset; use pagination.nextOffset for the next page."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 200,
      "description": "Maximum Hotspots on this page."
    }
  },
  "additionalProperties": false
}