Plugins
Templates
Powered By GitBook
Helium Blockchain API

Useful links

Introduction

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.

How To Setup

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.

Data Call

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 image below.

Action Call

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.

Stats

Blockchain Stats

Retrieve basic stats for the blockchain such as total token supply, and average block and election times over a number of intervals.

Response

1
{
2
"data": {
3
"token_supply": 88379262.2402527,
4
"state_channel_counts": {
5
"last_week": {
6
"num_packets": 3797153,
7
"num_dcs": 4695290
8
},
9
"last_month": {
10
"num_packets": 21154931,
11
"num_dcs": 26236381
12
},
13
"last_day": {
14
"num_packets": 465007,
15
"num_dcs": 585635
16
}
17
},
18
"fees": {
19
"last_week": {
20
"transaction": 874890000,
21
"staking": 19912000000
22
},
23
"last_month": {
24
"transaction": 3394714000,
25
"staking": 72120000000
26
},
27
"last_day": {
28
"transaction": 146620000,
29
"staking": 3516000000
30
}
31
},
32
"election_times": {
33
"last_week": {
34
"stddev": 1215.199844341099,
35
"avg": 2828.9018691588785
36
},
37
"last_month": {
38
"stddev": 1823.564045719447,
39
"avg": 2773.3811563169165
40
},
41
"last_hour": {
42
"stddev": 465.276262020748,
43
"avg": 2566
44
},
45
"last_day": {
46
"stddev": 964.07260133517,
47
"avg": 2805.2258064516127
48
}
49
},
50
"counts": {
51
"transactions": 58971043,
52
"hotspots": 42185,
53
"countries": 75,
54
"consensus_groups": 21980,
55
"cities": 5070,
56
"challenges": 21890665,
57
"blocks": 858606
58
},
59
"challenge_counts": {
60
"last_day": 40991,
61
"active": 0
62
},
63
"block_times": {
64
"last_week": {
65
"stddev": 28.124260410538735,
66
"avg": 64.85907335907336
67
},
68
"last_month": {
69
"stddev": 36.83723999681685,
70
"avg": 63.5599450697663
71
},
72
"last_hour": {
73
"stddev": 19.73937874402946,
74
"avg": 60.62068965517241
75
},
76
"last_day": {
77
"stddev": 26.01631045502151,
78
"avg": 63.70575221238938
79
}
80
}
81
}
82
}
Copied!

Token Supply

Returns the circulating token supply.

Response

1
{
2
"data": {
3
"token_supply": 88379262.1505514
4
}
5
}
Copied!

Blocks

Block Height

Gets the current height of the blockchain.
Block Height
Investopedia
​
Query Parameters
Name
Tags
Description
Example
Type
max_height
optional
Last time to include in height search.
2021-01-01
ISO8601 timestamp

Response

1
{
2
"data": {
3
"height": 644081
4
}
5
}
Copied!
​

Block Stats

Get statistics on block production times.
1
{
2
"data": {
3
"last_day": {
4
"avg": 62.31024531024531,
5
"stddev": 27.476995228717882
6
},
7
"last_hour": {
8
"avg": 57.04838709677419,
9
"stddev": 14.35889787468274
10
},
11
"last_month": {
12
"avg": 60.905921680993316,
13
"stddev": 45.412766632370634
14
},
15
"last_week": {
16
"avg": 61.16405380803075,
17
"stddev": 28.40161296349413
18
}
19
}
20
}
Copied!

Block Descriptions

Retrieves block descriptions. Blocks descriptions are paged. A cursor field will be in the response when more results are available.

Query Parameters

Name
Tags
Description
Example
Type
height
optional
Cursor for the page to fetch.
eyJiZWZvcmUiOjQzNTIwMX0
text

Response

1
{
2
"data": [
3
{
4
"transaction_count": 25,
5
"time": 1595978521,
6
"snapshot_hash": "",
7
"prev_hash": "BLlAdSn-TV2SLQzj-52UYRckLCE-D5BrZir09eVEEcQ",
8
"height": 435215,
9
"hash": "qqLVA7QELYoVFE0hoTUFy-5ZR6pPueORPYU3N8rLoQs"
10
},
11
{
12
"transaction_count": 104,
13
"time": 1595977735,
14
"snapshot_hash": "",
15
"prev_hash": "4Bbk2hlXB9Ophgn4jk-2QH_6HeAzn12yom04WtkoPbM",
16
"height": 435201,
17
"hash": "IFf8Mv0rihCic2wGLA-d2ticcmDp5baPXjqSEzt_Q-w"
18
}
19
],
20
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
21
}
Copied!
​

Block at Height

Get block descriptor for the block at height

Query Parameters

Name
Tags
Description
Example
Type
height
required
Blockchain Height.
644081
number

Response

1
{
2
"data": {
3
"transaction_count": 37,
4
"time": 1582192928,
5
"snapshot_hash": "",
6
"prev_hash": "Xj6vrBi_IcP0vqHHawf0FFWkG1qn18I9thQKOEhblXg",
7
"height": 213787,
8
"hash": "o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg"
9
}
10
}
Copied!

​

Block at Height Transactions

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.

Query Parameters

​
Name
Tags
Description
Example
Type
height
required
Blockchain Height.
644081
number
cursor
optional
Cursor for page to fetch.
eyJiZWZvcmUiOjQzNTIwMX0
text

Response

1
{
2
"data": [
3
{
4
"version": 2,
5
"type": "poc_request_v1",
6
"time": 1582192928,
7
"signature": "MEUCIEtI0JUGWFDZxdZ-MqaamBibe9XA7Hu7KtppFxER2_VlAiEAjmdtV8WcdyTVOMF1wLSiRXtsim2cEndKnnhavPAj7ms",
8
"secret_hash": "PDp3wlQDWQHOv3_cYO3iXSGO5lQPY-nk0nGZ-aCWj6U",
9
"owner": "13RU6fRkU1uGviyWJzgSVJAiVDhyf97dqBDMTmVjHEAuBy5LN1F",
10
"onion_key_hash": "T9wxjep44KOQrgw7L7nTBUlTp87BL1lvyCievMmxSHo",
11
"location": "8c2a30650aad7ff",
12
"lng": -71.1952338305713,
13
"lat": 42.34690845297784,
14
"height": 213787,
15
"hash": "0XQR1wmeqRYF8BeIPLtqr7ZZQHLWAg7CavmKPrSxF8w",
16
"fee": 0,
17
"challenger": "11mxTwhQVMS9o5GqaQ3MW9NbJeQM8x89e52YG3Em4turgAHPSgs",
18
"block_hash": "XcQXEO8eeJeCQ1V6hcCBMH06a1pOZXxrUBp-2NhM8Yg"
19
},
20
{
21
"version": 2,
22
"type": "poc_request_v1",
23
"time": 1582192928,
24
"signature": "MEQCIBDls8CH7DspVWl0IC77XLzzt7wHygTukGlibTygCP3QAiAl9fR9dNgLgaSIkl4cqBrSqjtbtu_Eg1UeMjRqmi9mog",
25
"secret_hash": "SR-livfqQa58lN3WX5a9jIBUW63DFOUUAgCC27WRu6I",
26
"owner": "13BPvTrw32jdsBPJYnL7whYghwLboCqipTaJbhSEaaZVzgmEemm",
27
"onion_key_hash": "R9GPq3ssxi6LW_iuj-7KqSwKSmZ_in7EdJEGWcVrWbs",
28
"location": "8c489e3534f45ff",
29
"lng": -97.68010436306147,
30
"lat": 30.30448054652587,
31
"height": 213787,
32
"hash": "eMNvkAotMP4e3xAfN1gh5oc5CTXnIhf2sIxijE3oZXA",
33
"fee": 0,
34
"challenger": "117r6sxGnFD3n5GnMTqSfhLxYqoXcDvFpzjNkweD8ZhPr9YQLRU",
35
"block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y"
36
},
37
{
38
"type": "poc_receipts_v1",
39
"time": 1582192928,
40
"signature": "MEQCIGVhWn3s3_2HYQzGNFi2GmV3xsr8Nm2EemoHNyqPNb33AiAPOfTXQKEo6Ol1H6JnlNTihUDpK5qtVRM6JSEDaVNvYA",
41
"secret": "AJswL6q6bm7bGIwk3jzzyH0kDGSJHb14ZnI2GgVApo8uBC3mU933j0w0_5rF3ejIZdLSusOmCZdzhoag7RtADi6OGXHHEdRNfTIDYR_41sddC0mqPE8A3NXXo2mzpqqkgo4",
42
"path": [
43
{
44
"witnesses": [],
45
"receipt": {
46
"timestamp": 1582192367974227200,
47
"signature": "MEUCIDD9BLjC_ghbIe7zhKQtDrhrlLD1BJgI_95ryQ6CFyyOAiEA1BZj_-faF_d7PFela0-EC6meWh3Wbe749I73Ta5gnyM",
48
"signal": 0,
49
"origin": "p2p",
50
"gateway": "112oQLEtxFFw4NrPZ7d1DFM1iScCunu5xvea99kVVTorNo16cBKg",
51
"data": "NJA"
52
},
53
"challengee": "112oQLEtxFFw4NrPZ7d1DFM1iScCunu5xvea99kVVTorNo16cBKg"
54
},
55
{
56
"witnesses": [],
57
"receipt": null,
58
"challengee": "112SVQqroQvvq2rQHKWYfxP2eRb91NLXU8qduBCLt1B1DmLK6Xj"
59
},
60
{
61
"witnesses": [],
62
"receipt": null,
63
"challengee": "1125H31qsBackYPLiYQQYHvxi6bRxzcfjRK5aJv1gA2ZwKb7WYL7"
64
}
65
],
66
"onion_key_hash": "qDnv0zJGjHUvgZTmGyJspRiPZvktTqQ-enBE43xrceg",
67
"height": 213787,
68
"hash": "GJMR4wfeHPC2xBhGM4vQqu344dyQdn7TZUpzNFu3baA",
69
"fee": 0,
70
"challenger_owner": "13uJVUm1U2iFZHhmFNp4E6L6v9rkjoABicw1SFC424rqadj7Qg5",
71
"challenger_loc": "8c48eba0b2d11ff",
72
"challenger": "112fpjqDuU3MequG617EuQ3xhtdecz6ah2WxJK87XqfHL5jnSdvc"
73
}
74
]
75
}
Copied!

Block at Hash

Get block descriptor for the given block hash.

Query Parameter

Name
Tags
Description
Example
Type
hash
required
Block hash for the block to fetch.
o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg
text

Response

1
{
2
"data": {
3
"transaction_count": 37,
4
"time": 1582192928,
5
"snapshot_hash": "",
6
"prev_hash": "Xj6vrBi_IcP0vqHHawf0FFWkG1qn18I9thQKOEhblXg",
7
"height": 213787,
8
"hash": "o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg"
9
}
10
}
Copied!

Block at Hash Transactions

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.

Query Parameters

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

Response

1
{
2
"data": [
3
{
4
"version": 2,
5
"type": "poc_request_v1",
6
"time": 1582192928,
7
"signature": "MEUCIEtI0JUGWFDZxdZ-MqaamBibe9XA7Hu7KtppFxER2_VlAiEAjmdtV8WcdyTVOMF1wLSiRXtsim2cEndKnnhavPAj7ms",
8
"secret_hash": "PDp3wlQDWQHOv3_cYO3iXSGO5lQPY-nk0nGZ-aCWj6U",
9
"owner": "13RU6fRkU1uGviyWJzgSVJAiVDhyf97dqBDMTmVjHEAuBy5LN1F",
10
"onion_key_hash": "T9wxjep44KOQrgw7L7nTBUlTp87BL1lvyCievMmxSHo",
11
"location": "8c2a30650aad7ff",
12
"lng": -71.1952338305713,
13
"lat": 42.34690845297784,
14
"height": 213787,
15
"hash": "0XQR1wmeqRYF8BeIPLtqr7ZZQHLWAg7CavmKPrSxF8w",
16
"fee": 0,
17
"challenger": "11mxTwhQVMS9o5GqaQ3MW9NbJeQM8x89e52YG3Em4turgAHPSgs",
18
"block_hash": "XcQXEO8eeJeCQ1V6hcCBMH06a1pOZXxrUBp-2NhM8Yg"
19
},
20
{
21
"version": 2,
22
"type": "poc_request_v1",
23
"time": 1582192928,
24
"signature": "MEUCIQCUJskKawMwc9G3Uv_ZRYrhSrHo4QoNuZT4amHVS3rkmQIgJ_RZ-9z3v9T5JNwnAtDTynwJpqO1cQ3KHPBeFGxRBQY",
25
"secret_hash": "B7scyTy8h6nsXymcrXPaCt0MShUGki2fvPx7lsmRkXc",
26
"owner": "13Wjb3U16ct477Qixg45nWEtRh4Jg2qTp2iuqgD2Adk8gQmF8Bo",
27
"onion_key_hash": "1xip4moxB5lx8UO5Dwo35ppMfJi_ASSgxsYaLPaHLRU",
28
"location": "8c44c13164947ff",
29
"lng": -84.23063101246672,
30
"lat": 33.85883850690923,
31
"height": 213787,
32
"hash": "6J8ZsZjDF2tiStMOVjtEG9jaKnpLZfAwY4jXx9bX1y4",
33
"fee": 0,
34
"challenger": "1181v5Saf87iUexQ8WtqA6xLrzbuF2UaS6dGY8R8p4yqoK1ZjMA",
35
"block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y"
36
},
37
{
38
"version": 2,
39
"type": "poc_request_v1",
40
"time": 1582192928,
41
"signature": "MEQCIEEk2H6NFe9CY7ZtoPPr-9cyBDuDCTvrOOzKpPW7ldIAAiAfGXSl2cgqtVzN8um0PyCTr_dD8_Gmp2CwL8SEkuv1Ew",
42
"secret_hash": "zCA4W7sUqVu6Gzpz-5TUbzxTTv8SbY0B74VCIp46Hys",
43
"owner": "14MRMNbNQidNFTszjoYugvMPxQLqLoZyPADSwJKvvnzgd8UX2UZ",
44
"onion_key_hash": "PyGkman-6k81fdcQn9_DS9dJLRo9r4P9ijpRxPnM4-E",
45
"location": "8c2663d04684bff",
46
"lng": -88.31876752603684,
47
"lat": 40.10013118277986,
48
"height": 213787,
49
"hash": "_aOH3TaNbUXB-aETIk7bsUyH6p9HOWDfx3P5wXBxnQQ",
50
"fee": 0,
51
"challenger": "11K6YeKEqfwMJu2wy64YHdQhXT8Hy5aMA4SxFdvCR4zwQyF17Xo",
52
"block_hash": "znLXFN1OaN6aosWTZRmpZ2SIu0wiT4LKG3VkDpf8oqA"
53
},
54
{
55
"version": 2,
56
"type": "poc_request_v1",
57
"time": 1582192928,
58
"signature": "MEUCIGCf9Mxj5P9aeuIwbhMrGkhVORX9ymsditZ8jwgrRGoTAiEAmv6oeps953HnAGjtW6b7yu6gKiGYDXneMJxOPPX5cN4",
59
"secret_hash": "otNY8AVs8_JsIay-CA5XXAiKInVEx00lwXnLBIAfWKo",
60
"owner": "135qJwSQD2eFBsDjcDWKRgJucKRocVLvxrunc1W9KhcJe9CAp4G",
61
"onion_key_hash": "lEEBV1DODq5iFKYq4h6mmb-Oba-6dcYfQ3cMUjFhxHc",
62
"location": "8c2a107a90b09ff",
63
"lng": -74.21400962950572,
64
"lat": 40.68133174681411,
65
"height": 213787,
66
"hash": "AqLEUGRylc9kfW_tyLMwTJPunVXmlqh5ZrzYVUWxBIE",
67
"fee": 0,
68
"challenger": "11cpn65Uuugxs9YAAvYc1i7J9xgWY2pjSj4Y2FFvaFypa8bccLq",
69
"block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y"
70
},
71
{
72
"version": 2,
73
"type": "poc_request_v1",
74
"time": 1582192928,
75
"signature": "MEUCIGPQZRXlxMMJXAiOyYAja70dC6HihyvXNoDRTno3Rw7gAiEAsKS_4qaQ0zLf42sW1SaLnqfb1mUquwFpHbU0-lo21yo",
76
"secret_hash": "CZjCoW6RU6TejMQjhgePVXPc759u5yp04Y9z5ye5C28",
77
"owner": "14gaNAfNSL8pPAVjTyy8LhRjVgw9t8JunooEmCSyXLAX9A3pfMF",
78
"onion_key_hash": "mWsd00ByHhfa_2J-CpphhbhSIiqg58_tMiYkoOBEU6Y",
79
"location": "8c2a340910313ff",
80
"lng": -70.2707016518933,
81
"lat": 43.655908895594315,
82
"height": 213787,
83
"hash": "bdkRW7Dxx-ESPSz7i_vxk-jXIqUfmFL9pZUWYmJOwYU",
84
"fee": 0,
85
"challenger": "112u5QmxT5LVrD9vdtT1hJ7bBEdqthhbbefTaNK1JCS5n4xbKRoo",
86
"block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y"
87
},
88
{
89
"version": 2,
90
"type": "poc_request_v1",
91
"time": 1582192928,
92
"signature": "MEQCIDDdF3MhXzgLzVRHi6-x55ASjv9BtbIneBMyGekAThY0AiApKRRfmZRVYt-7Bx_le9uaUmmWYkWPv1IXDXRgCGR1Ww",
93
"secret_hash": "Upa8MV8OvHZBddL-GLAyeNTJ7P80vTAxYFsTI25AnOk",
94
"owner": "139fiM2t9SGU8yB1QG5GxRy9qztpcnjr1F5u7Paop9Lsh7G31sn",
95
"onion_key_hash": "F2lzKJQyFet4zkgVaqR9FeO1i6SqICpaN5P1RfbM07E",
96
"location": "8c44d9975282bff",
97
"lng": -82.72848196624813,
98
"lat": 35.533213738889785,
99
"height": 213787,
100
"hash": "c-6u-jO4YX0dgxXSUMK7HKxdPUmxbxwXCbHblKDbHjQ",
101
"fee": 0,
102
"challenger": "112oBX3SKsRdxXD97dNVL8k5ejnS6bYiKxjWeRS2yuj8gCkgLUb1",
103
"block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y"
104
},
105
{
106
"version": 2,
107
"type": "poc_request_v1",
108
"time": 1582192928,
109
"signature": "MEQCIEQkbbVN05yp4ynRKCdnXbPBOADm645fVXXg3wQ5EGgJAiAqO__gcfiLdmPqtofKvf1XAnXL6oyTe2f6YSIkatGfMg",
110
"secret_hash": "0RusqDuS5D1l6VxHHqOfYKN3_dRzS9glMuv9XhlHJOc",
111
"owner": "14FrS6JfobouRDVf7FbYuvvR5uNzB688qESpQNXLoaCqd1zDN7P",
112
"onion_key_hash": "VQuQlV7KfjAK2xT0CqP6a-qt_sZHBD5AQKeHOiSRMeE",
113
"location": "8c2a122dbb893ff",
114
"lng": -75.27858120362838,
115
"lat": 40.236503579574276,
116
"height": 213787,
117
"hash": "CGjUzaSOqukYqnJK2zYd0YuvGea0MrNdlRCubhEPbag",
118
"fee": 0,
119
"challenger": "112a5Mzuhw4h9Er29yGhsYLi9FePQmzmgyKXZW53to8uXHzZYSS3",
120
"block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y"
121
},
122
{
123
"version": 2,
124
"type": "poc_request_v1",
125
"time": 1582192928,
126
"signature": "MEYCIQC0VJsxXtXeYR_NAOtoFz3C-tbOam3sQFKMAyufH0RdGgIhAKK0BBiCJYOOpDVikt1jbxMUscVz9q3gRTrw9ga1NNJ0",
127
"secret_hash": "30jwhK8zdNvluN4ikCymnWo3GBwYfyWk1fALTBFYcHU",
128
"owner": "13T8w9Y88SEqbuzRkDq49xHKfX57cJbbv5y1fTqMU79Wu1q1o5j",
129
"onion_key_hash": "1oYPe7schX1Ph2ZpP4zGGOviXfBLoZlF_WK3usuelac",
130