Link to plugin page: https://zeroqode.com/plugin/helium-blockchain-api-1625574636597x896820748219226100
Helium is a decentralized, open wireless network built on a new blockchain for the physical world. It relies on a novel type of work called Proof of Coverage, and a new consensus algorithm. The Helium Network is used to route data for long-range, lower power IoT devices that use Helium's LongFi protocol.
This plugin will allow you to easily interact with the Helium network to build applications & services for the Helium ecosystem.
There is no authentication required for interacting with Helium's & The API is not rate limited.
Every endpoint has both action and get data call. Below is an example of how to use the endpoints in either scenario.
A simple example of using this plugin's data-calls is with a Bubble text element. Draw a text element to your page, focus the editable input & click dynamic data.
Select the option 'Get data from an external API'
Here you can choose any of the plugin's API calls to use
In this example we have selected 'List Richest Accounts'. This will return a custom datatype not readable in text format so we must complete the expression by calling a field.
Balances or anything referring to HNT (Heliums native token is in $USD) and can be divided by 100000000 for easier reading.
You will notice when clicking the expression a panel on the left will appear showing some inputs to control the returned data, some these are required while others are optional.
Bubble's editor doesn't prompt you that it must be filled in so refer to the respective documentation. In our example, the 'Version' path parameter is required but the 'limit' query parameter is not.
You can easily find the documentation for every call in the plugins tab, see the image below.
To use action calls in your workflows either use the search input or click the plugins tab to find the list.
Then in your subsequent action, you can use the output data from this action with the 'Result of Step n' operator.
Retrieve basic stats for the blockchain such as total token supply, and average block and election times over a number of intervals.
Returns the circulating token supply.
Gets the current height of the blockchain.What Is Block Height? - https://www.investopedia.com/terms/b/block-height.asp
Query Parameters
Name | Tags | Description | Example | Type |
max_height | optional | Last time to include in height search. | 2021-01-01 | ISO8601 timestamp |
Get statistics on block production times.
Retrieves block descriptions. Blocks descriptions are paged. A cursor field will be in the response when more results are available.
Name | Tags | Description | Example | Type |
height | optional | Cursor for the page to fetch. | eyJiZWZvcmUiOjQzNTIwMX0 | text |
Get block descriptor for the block at height
Name | Tags | Description | Example | Type |
height | required | Blockchain Height. | 644081 | number |
Get transactions for a block at a given height. The list of returned transactions is paged. A cursor field is present if more results are available.
Name | Tags | Description | Example | Type |
height | required | Blockchain Height. | 644081 | number |
cursor | optional | Cursor for page to fetch. | eyJiZWZvcmUiOjQzNTIwMX0 | text |
Get block descriptor for the given block hash.
Name | Tags | Description | Example | Type |
hash | required | Block hash for the block to fetch. | o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg | text |
Get transactions for a block at a given block hash. The list of returned transactions is paged. A cursor field is present if more results are available.
Name | Tags | Description | Example | Type |
hash | required | Block hash for the block to fetch. | o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg | text |
cursor | optional | Cursor for page to fetch. | eyJiZWZvcmUiOjQzNTIwMX0 | text |
Retrieve basic stats for the blockchain such as total token supply, and average block and election times over a number of intervals.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for page to fetch. Note: The cursor for accounts is valid for a limited time. | eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0 | text |
Returns up to 100 of the accounts sorted by highest token balance.
Name | Tags | Description | Example | Type |
limit | optional | counts to return. Default 100, max 100. | 10 | number |
Retrieve a specific account record. The account details for a record include additional speculative nonces that indicate what the expected nonce for the account is for a specific balance. Any transactions affecting the given balance type should use an adjusted speculative nonce for that balance type.
Fetches hotspots owned by a given account address.The list of returned hotspots is paged. If a cursor field is present more results are available.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for the next page of hotspots to fetch. | eyJiZWZvcmUiOjQzNTIwMX0 | text |
Fetches OUIs owned by a given account address.The list of returned OUIs is paged. If a cursor field is present more results are available.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for the next page of OUIs to fetch. | eyJiZWZvcmUiOjQzNTIwMX0 | text |
Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for the next page of activity to fetch. | eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0 | text |
Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.Count transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.The results are a map keyed by the given filter_types and the count of transaction of that type.
Append the version on the transaction type name, eg: payment_v1
Name | Tags | Description | Example | Type |
optional | Comma separated list of transaction types. | rewards_v1 , payment_v1 | array enum |
Fetches elections that hotspots for the given account are elected in.
Fetches challenges that hotspots owned by the given account are involved in as a challenger, challengee, or witness.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for the next page of challenges to fetch. | eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0 | text |
Fetches the outstanding transactions for the given account.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for the next page of challenges to fetch. | eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0 | text |
Returns reward entries by block and gateway for a given account in a timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
The results can be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed per hotspot and time for the account to make hotspot performance comparison possible. Valid bucket values include hour, dayand week).
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for the next page of pending transactions to fetch. | eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcw | ISO8601 timestamp or relative time |
Returns reward entries by block and gateway for a given account in a timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
The results can be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed per hotspot and time for the account to make hotspot performance comparison possible. Valid bucket values include hour, day and week).
Name | Tags | Description | Example | Type |
min_time | required | First time to include rewards sum for. | 2020-08-27T00:00:00Z | ISO8601 timestamp or relative time |
max_time | required | Last time to include rewards for. | -1 week | ISO8601 timestamp or relative time |
bucket | optional | Bucket specifier. | day | enum |
Fetches account statistics for a given account. This currently includes account balance information (in bones) for the last month (daily), last week (every 8 hours), and daily (hourly)
List all known hotspot cities with the total hotspot count for each city.
Lists all known hotspots for a given city_id.
List known hotspots as registered on the blockchain.The results are paged. If a cursor field is present in the response, more results are available.
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for page to fetch. | eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0 | text |
List known hotspots as registered on the blockchain.The results are paged. If a cursor field is present in the response, more results are available.
Fetch the hotspots which map to the given 3-word animal name. The name must be all lower-case with dashes between the words, e.g. tall-plum-griffin. Because of collisions in the Angry Purple Tiger algorithm, the given name might map to more than one hotspot.
Fetch the hotspots which are within a given number of meters from the given lat and lon coordinates.
Name | Tags | Description | Example | Type |
lat | required | Latitude of the location to search around. | 37.784056617819544 | float |
lon | required | Longitude of the location to search around | -122.39186733984285 | float |
distance | required | Distance (in meters) from location to search within | 200 | number |
cursor | optional | Cursor for page to fetch | eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0 | text |
Fetch the hotspots which are within a given geographic boundary indicated by it's south-wesetern and north-eastern co-ordinates.
Name | Tags | Description | Example | Type |
swlat | required | Latitude of the south-west corner | 38.0795392 | float |
swlon | required | Longitude of the south-west corner. | -122.5671627 | float |
nelat | required | Latitude of the north-east corner | 38.1588012 | float |
nelon | required | Longitude of the north-east corner | -122.5046937 | float |
cursor | optional | Cursor for page to fetch | eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn | text |
Fetch the hotspots which are in the given h3 index. The supported h3 indices are currently limited to resolution 8.
Name | Tags | Description | Example | Type |
h3_index | required | The h3 index to fetch hotspots for | 882aa38c2bfffff | text |
Lists all blockchain transactions that the given hotspot was involved in.
Name | Tags | Description | Example | Type |
address | required | B58 address of the hotspot. | 11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db | text |
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for page of results to fetch. | eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0 | text |
Count transactions that indicate activity for a hotspot.The results are a map keyed by the given filter_types and the count of transaction of that type.
Append the version on the transaction type name, eg: payment_v1
Name | Tags | Description | Example | Type |
optional | Comma separated list of transaction types. | rewards_v1 , payment_v1array | enum |
Lists all blockchain transactions that the given hotspot was involved in.https://docs.helium.com/blockchain/consensus-protocol/
Name | Tags | Description | Example | Type |
address | required | B58 address of the hotspot to look up. | 11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE | text |
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for page of results to fetch. | eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0 | text |
Returns the list of hotspots that are currently elected to the consensus group.
Lists the challenge (receipts) that the given hotspot a challenger, challengee or a witness in. This route is paged using a cursor.
Name | Tags | Description | Example | Type |
address | required | B58 address of the hotspot to look up. | 11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ | text |
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for page of results to fetch. | eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwf | text |
Returns rewards for a given hotspot per reward block the hotspot is in, for a given timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
Name | Tags | Description | Example | Type |
address | required | B58 address of the hotspot to look up. | 11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ | text |
Name | Tags | Description | Example | Type |
cursor | optional | Cursor for page of results to fetch. | eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwf | text |
max_time | required | Last timestamp to include rewards for | 2020-08-27T00:00:00Z | |
min_time | required | First timestamp to include rewards for. | -1 week | |
Untitled | | | | |
Returns the total rewards earned for a given hotspot over a given time range. Timestamps are given in ISO 8601 format. The block that includes the max_time timestamp is excluded from the result.
Name | Tags | Description | Example | Type |
address | required | B58 address of the hotspot to look up. | 11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ | text |
The results can be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed per hotspot and time for the account to make hotspot performance comparison possible. Valid bucket values include hour, day and week).
Retrieves the last known list of witnesses for a given hotspot. In addition to the hotspot result information, the result will also include a witness_for and a witness_info field which are the given hotspot address and bucket histogram information on witnessed signal strengths.
Name | Tags | Description | Example | Type |
address | required | B58 address of the hotspot to look up. | 11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ | text |
Get geographic information for a given location.
The current Oracle Price in $USD and at which block it took effect. The last 7 digits are decimals, cent denominations.
The current and historical Oracle Prices and at which block they took effect. This route is paged using a cursor.
Name | Tags | Description | Example | Type |
cursor | optional | Returned from an initial query, allowing client to fetch more results. | eyJiZWZvcmUiOjQ2NjE5MH0 | text |
Gets statistics on Oracle prices.
Provides the oracle price at a specific block and at which block it initially took effect.