# Helium

> Look up Hotspots on the Helium wireless network: where a Hotspot is, which networks it serves and its antenna details. See every Hotspot a wallet owns along with its HNT, MOBILE, IOT and Data Credit balances, count the Hotspots on the IoT and Mobile networks, list them page by page, and look up the organizations that route LoRaWAN traffic. Uses Helium's own free Entity API. No account or API key required.

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/helium

## Actions

### Count hotspots on the network

Get how many Hotspots are on Helium's IoT Network and on its Mobile Network, to track the network's growth over time. No API key required.

**Inputs**: None.

**Outputs**

- `iot_hotspot_count` (number): Hotspots on the IoT Network (LoRaWAN).
- `mobile_hotspot_count` (number): Hotspots on the Mobile Network.

**Example output**

```json
{
  "iot_hotspot_count": 1035724,
  "mobile_hotspot_count": 58074
}
```

### Get a hotspot

Look up a Helium Hotspot by its address: its name, which networks it's on, where it is, and its antenna details. No API key required.

**Inputs**

- Hotspot address (`hotspot`, text, required): The Hotspot's Helium address, as the Helium Wallet app or an explorer shows it. Its Solana key or a link to its explorer page work too.

**Outputs**

- `hotspot` (object): The Hotspot and where it is.

**Example output**

```json
{
  "hotspot": {
    "asset_id": "DUcctHUAXEzFvpRkkMTFx9Hfs7JaEHB6dVoqPyovqhdG",
    "city": "Seattle",
    "country": "United States",
    "hotspot_address": "11eZiUUcJkXLXuFeETcMxckm4rXP7yZfHW3NoM38HTx4hLePDvK",
    "hotspot_key": "3t47wfGTY1Wq9MWWFkyFAQwVi2W2NaZbWWu9LGBf26Hj",
    "image_url": "https://entities.nft.helium.io/v2/assets/hotspot-iot.png",
    "iot_added_at": "2025-08-05T16:38:24.877Z",
    "iot_antenna_gain_dbi": 1.2,
    "iot_city": "Seattle",
    "iot_country": "United States",
    "iot_elevation_m": 6,
    "iot_latitude": 47.496817,
    "iot_longitude": -122.249282,
    "iot_state": "Washington",
    "iot_street": null,
    "is_rewardable": true,
    "latitude": 47.496817,
    "longitude": -122.249282,
    "mobile_added_at": "2023-04-23T21:24:24.323Z",
    "mobile_city": "Seattle",
    "mobile_country": "United States",
    "mobile_device_type": "CBRS radio",
    "mobile_latitude": 47.496817,
    "mobile_longitude": -122.249282,
    "mobile_state": "Washington",
    "mobile_street": null,
    "name": "Long Orchid Skunk",
    "network_names": "IoT, Mobile",
    "networks": [
      "iot",
      "mobile"
    ],
    "state": "Washington"
  }
}
```

### Get a LoRaWAN organization

Look up one organization on Helium's IoT Network by its number (OUI): who owns it, who pays for its traffic, and whether its routing is locked. No API key required.

**Inputs**

- Organization (OUI) (`oui`, text, required): The organization's number, called an OUI. Pick it from the list or type it.

**Outputs**

- `organization` (object): An organization that routes LoRaWAN device traffic.

**Example output**

```json
{
  "organization": {
    "delegate_count": 1,
    "delegate_keys": [
      "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
    ],
    "escrow": "6QQNxU671ztxwEcNZn1qvA5KXv6Lb3objKDU3pBqc96w",
    "is_locked": false,
    "oui": 1,
    "owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc",
    "payer": "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
  }
}
```

### Get a wallet's hotspots and balances

See every Hotspot a Helium wallet owns and how much HNT, MOBILE, IOT and Data Credits it holds. Use it to keep an eye on your fleet or your earnings. No API key required.

**Inputs**

- Wallet address (`wallet`, text, required): The wallet's Solana address, from the Helium Wallet app: 32 to 44 letters and numbers.
- Hotspots to return (`limit`, number): Optional. The most Hotspots to include, between 1 and 500; 100 by default. The Hotspot count always covers all of them. From 1 to 500. Default: `100`.

**Outputs**

- `data_credits` (number): The wallet's Data Credits, which pay for sending data over the network.
- `hnt_balance` (number): The wallet's HNT, Helium's main token.
- `hotspot_count` (number): How many Hotspots the wallet owns in total.
- `hotspots` (list): The wallet's Hotspots, up to the limit.
- `hotspots_returned` (number): How many Hotspots are in the list.
- `iot_balance` (number): The wallet's IOT tokens.
- `mobile_balance` (number): The wallet's MOBILE tokens.
- `wallet_address` (text): The wallet address that was looked up.

**Example output**

```json
{
  "data_credits": 0,
  "hnt_balance": 5861.07485006,
  "hotspot_count": 5,
  "hotspots": [
    {
      "asset_id": "DUcctHUAXEzFvpRkkMTFx9Hfs7JaEHB6dVoqPyovqhdG",
      "city": "Seattle",
      "country": "United States",
      "hotspot_address": "11eZiUUcJkXLXuFeETcMxckm4rXP7yZfHW3NoM38HTx4hLePDvK",
      "hotspot_key": "3t47wfGTY1Wq9MWWFkyFAQwVi2W2NaZbWWu9LGBf26Hj",
      "image_url": "https://entities.nft.helium.io/v2/assets/hotspot-iot.png",
      "iot_added_at": "2025-08-05T16:38:24.877Z",
      "iot_antenna_gain_dbi": 1.2,
      "iot_city": "Seattle",
      "iot_country": "United States",
      "iot_elevation_m": 6,
      "iot_latitude": 47.496817,
      "iot_longitude": -122.249282,
      "iot_state": "Washington",
      "iot_street": null,
      "is_rewardable": true,
      "latitude": 47.496817,
      "longitude": -122.249282,
      "mobile_added_at": "2023-04-23T21:24:24.323Z",
      "mobile_city": "Seattle",
      "mobile_country": "United States",
      "mobile_device_type": "CBRS radio",
      "mobile_latitude": 47.496817,
      "mobile_longitude": -122.249282,
      "mobile_state": "Washington",
      "mobile_street": null,
      "name": "Long Orchid Skunk",
      "network_names": "IoT, Mobile",
      "networks": [
        "iot",
        "mobile"
      ],
      "state": "Washington"
    }
  ],
  "hotspots_returned": 1,
  "iot_balance": 31755.060363,
  "mobile_balance": 1000.0,
  "wallet_address": "hntyVP6YFm1Hg25TN9WGLqM12b8TQmcknKrdu1oxWux"
}
```

### List hotspots

List the Hotspots on the IoT or Mobile network, a page at a time, with each one's address and approximate location. No API key required.

**Inputs**

- Network (`network`, text): Which Helium network to list. One of: `iot` (IoT Network (LoRaWAN)), `mobile` (Mobile Network). Default: `iot`.
- Number of hotspots (`limit`, number): Optional. How many Hotspots to return, between 1 and 1000; 100 by default. From 1 to 1000. Default: `100`.
- Next page (`page_token`, text): Optional. Leave empty for the first page. To get the next one, pass the next page token from the previous List hotspots step.

**Outputs**

- `count` (number): How many Hotspots are in this page.
- `has_more` (true/false): True when there are more pages.
- `hotspots` (list): The Hotspots in this page.
- `network` (text): The network that was listed: iot or mobile.
- `next_page_token` (text): Pass this as Next page to get the following page. Empty on the last page.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "hotspots": [
    {
      "hotspot_address": "11eZiUUcJkXLXuFeETcMxckm4rXP7yZfHW3NoM38HTx4hLePDvK",
      "hotspot_key": "3t47wfGTY1Wq9MWWFkyFAQwVi2W2NaZbWWu9LGBf26Hj",
      "latitude": 47.496817,
      "longitude": -122.249282
    }
  ],
  "network": "iot",
  "next_page_token": "~100"
}
```

### List LoRaWAN organizations

List the organizations that route LoRaWAN device data over Helium's IoT Network, each with its number (OUI) and whether its routing is locked. No API key required.

**Inputs**: None.

**Outputs**

- `count` (number): How many organizations there are.
- `organizations` (list): Every registered organization, by OUI.

**Example output**

```json
{
  "count": 1,
  "organizations": [
    {
      "delegate_count": 1,
      "delegate_keys": [
        "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
      ],
      "escrow": "6QQNxU671ztxwEcNZn1qvA5KXv6Lb3objKDU3pBqc96w",
      "is_locked": false,
      "oui": 1,
      "owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc",
      "payer": "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
    }
  ]
}
```