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.
Image without caption
Select the option β€˜Get data from an external API’
Image without caption
Here you can choose any of the plugin’s API calls to use
Image without caption
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.
Image without caption
❕
Balances or anything referring to HNT (Heliums native token is in $USD) and can be divided by 100000000 for easier reading.
Image without caption
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.
Image without caption
❕
You can easily find the documentation for every call in the plugins tab, see the image below.
Image without caption

Action Call

To use action calls in your workflows either use the search input or click the plugins tab to find the list.​
Image without caption
Then in your subsequent action, you can use the output data from this action with the β€˜Result of Step n’ operator.
Image without caption

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

javascript
{ "data": { "token_supply": 88379262.2402527, "state_channel_counts": { "last_week": { "num_packets": 3797153, "num_dcs": 4695290 }, "last_month": { "num_packets": 21154931, "num_dcs": 26236381 }, "last_day": { "num_packets": 465007, "num_dcs": 585635 } }, "fees": { "last_week": { "transaction": 874890000, "staking": 19912000000 }, "last_month": { "transaction": 3394714000, "staking": 72120000000 }, "last_day": { "transaction": 146620000, "staking": 3516000000 } }, "election_times": { "last_week": { "stddev": 1215.199844341099, "avg": 2828.9018691588785 }, "last_month": { "stddev": 1823.564045719447, "avg": 2773.3811563169165 }, "last_hour": { "stddev": 465.276262020748, "avg": 2566 }, "last_day": { "stddev": 964.07260133517, "avg": 2805.2258064516127 } }, "counts": { "transactions": 58971043, "hotspots": 42185, "countries": 75, "consensus_groups": 21980, "cities": 5070, "challenges": 21890665, "blocks": 858606 }, "challenge_counts": { "last_day": 40991, "active": 0 }, "block_times": { "last_week": { "stddev": 28.124260410538735, "avg": 64.85907335907336 }, "last_month": { "stddev": 36.83723999681685, "avg": 63.5599450697663 }, "last_hour": { "stddev": 19.73937874402946, "avg": 60.62068965517241 }, "last_day": { "stddev": 26.01631045502151, "avg": 63.70575221238938 } } } }

Token Supply

Returns the circulating token supply.

Response

javascript
{ "data": { "token_supply": 88379262.1505514 } }

Blocks

Block Height

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.
Jan 1, 2021
ISO8601 timestamp

Response

javascript
{ "data": { "height": 644081 }}

Block Stats

Get statistics on block production times.
javascript
{ "data": { "last_day": { "avg": 62.31024531024531, "stddev": 27.476995228717882 }, "last_hour": { "avg": 57.04838709677419, "stddev": 14.35889787468274 }, "last_month": { "avg": 60.905921680993316, "stddev": 45.412766632370634 }, "last_week": { "avg": 61.16405380803075, "stddev": 28.40161296349413 } }}

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

javascript
{ "data": [ { "transaction_count": 25, "time": 1595978521, "snapshot_hash": "", "prev_hash": "BLlAdSn-TV2SLQzj-52UYRckLCE-D5BrZir09eVEEcQ", "height": 435215, "hash": "qqLVA7QELYoVFE0hoTUFy-5ZR6pPueORPYU3N8rLoQs" }, { "transaction_count": 104, "time": 1595977735, "snapshot_hash": "", "prev_hash": "4Bbk2hlXB9Ophgn4jk-2QH_6HeAzn12yom04WtkoPbM", "height": 435201, "hash": "IFf8Mv0rihCic2wGLA-d2ticcmDp5baPXjqSEzt_Q-w" } ], "cursor": "eyJiZWZvcmUiOjQzNTIwMX0"}

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

javascript
{ "data": { "transaction_count": 37, "time": 1582192928, "snapshot_hash": "", "prev_hash": "Xj6vrBi_IcP0vqHHawf0FFWkG1qn18I9thQKOEhblXg", "height": 213787, "hash": "o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg" }}

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

javascript
{ "data": [ { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEUCIEtI0JUGWFDZxdZ-MqaamBibe9XA7Hu7KtppFxER2_VlAiEAjmdtV8WcdyTVOMF1wLSiRXtsim2cEndKnnhavPAj7ms", "secret_hash": "PDp3wlQDWQHOv3_cYO3iXSGO5lQPY-nk0nGZ-aCWj6U", "owner": "13RU6fRkU1uGviyWJzgSVJAiVDhyf97dqBDMTmVjHEAuBy5LN1F", "onion_key_hash": "T9wxjep44KOQrgw7L7nTBUlTp87BL1lvyCievMmxSHo", "location": "8c2a30650aad7ff", "lng": -71.1952338305713, "lat": 42.34690845297784, "height": 213787, "hash": "0XQR1wmeqRYF8BeIPLtqr7ZZQHLWAg7CavmKPrSxF8w", "fee": 0, "challenger": "11mxTwhQVMS9o5GqaQ3MW9NbJeQM8x89e52YG3Em4turgAHPSgs", "block_hash": "XcQXEO8eeJeCQ1V6hcCBMH06a1pOZXxrUBp-2NhM8Yg" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEQCIBDls8CH7DspVWl0IC77XLzzt7wHygTukGlibTygCP3QAiAl9fR9dNgLgaSIkl4cqBrSqjtbtu_Eg1UeMjRqmi9mog", "secret_hash": "SR-livfqQa58lN3WX5a9jIBUW63DFOUUAgCC27WRu6I", "owner": "13BPvTrw32jdsBPJYnL7whYghwLboCqipTaJbhSEaaZVzgmEemm", "onion_key_hash": "R9GPq3ssxi6LW_iuj-7KqSwKSmZ_in7EdJEGWcVrWbs", "location": "8c489e3534f45ff", "lng": -97.68010436306147, "lat": 30.30448054652587, "height": 213787, "hash": "eMNvkAotMP4e3xAfN1gh5oc5CTXnIhf2sIxijE3oZXA", "fee": 0, "challenger": "117r6sxGnFD3n5GnMTqSfhLxYqoXcDvFpzjNkweD8ZhPr9YQLRU", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "type": "poc_receipts_v1", "time": 1582192928, "signature": "MEQCIGVhWn3s3_2HYQzGNFi2GmV3xsr8Nm2EemoHNyqPNb33AiAPOfTXQKEo6Ol1H6JnlNTihUDpK5qtVRM6JSEDaVNvYA", "secret": "AJswL6q6bm7bGIwk3jzzyH0kDGSJHb14ZnI2GgVApo8uBC3mU933j0w0_5rF3ejIZdLSusOmCZdzhoag7RtADi6OGXHHEdRNfTIDYR_41sddC0mqPE8A3NXXo2mzpqqkgo4", "path": [ { "witnesses": [], "receipt": { "timestamp": 1582192367974227200, "signature": "MEUCIDD9BLjC_ghbIe7zhKQtDrhrlLD1BJgI_95ryQ6CFyyOAiEA1BZj_-faF_d7PFela0-EC6meWh3Wbe749I73Ta5gnyM", "signal": 0, "origin": "p2p", "gateway": "112oQLEtxFFw4NrPZ7d1DFM1iScCunu5xvea99kVVTorNo16cBKg", "data": "NJA" }, "challengee": "112oQLEtxFFw4NrPZ7d1DFM1iScCunu5xvea99kVVTorNo16cBKg" }, { "witnesses": [], "receipt": null, "challengee": "112SVQqroQvvq2rQHKWYfxP2eRb91NLXU8qduBCLt1B1DmLK6Xj" }, { "witnesses": [], "receipt": null, "challengee": "1125H31qsBackYPLiYQQYHvxi6bRxzcfjRK5aJv1gA2ZwKb7WYL7" } ], "onion_key_hash": "qDnv0zJGjHUvgZTmGyJspRiPZvktTqQ-enBE43xrceg", "height": 213787, "hash": "GJMR4wfeHPC2xBhGM4vQqu344dyQdn7TZUpzNFu3baA", "fee": 0, "challenger_owner": "13uJVUm1U2iFZHhmFNp4E6L6v9rkjoABicw1SFC424rqadj7Qg5", "challenger_loc": "8c48eba0b2d11ff", "challenger": "112fpjqDuU3MequG617EuQ3xhtdecz6ah2WxJK87XqfHL5jnSdvc" } ]}

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

javascript
{ "data": { "transaction_count": 37, "time": 1582192928, "snapshot_hash": "", "prev_hash": "Xj6vrBi_IcP0vqHHawf0FFWkG1qn18I9thQKOEhblXg", "height": 213787, "hash": "o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg" }}

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

javascript
{ "data": [ { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEUCIEtI0JUGWFDZxdZ-MqaamBibe9XA7Hu7KtppFxER2_VlAiEAjmdtV8WcdyTVOMF1wLSiRXtsim2cEndKnnhavPAj7ms", "secret_hash": "PDp3wlQDWQHOv3_cYO3iXSGO5lQPY-nk0nGZ-aCWj6U", "owner": "13RU6fRkU1uGviyWJzgSVJAiVDhyf97dqBDMTmVjHEAuBy5LN1F", "onion_key_hash": "T9wxjep44KOQrgw7L7nTBUlTp87BL1lvyCievMmxSHo", "location": "8c2a30650aad7ff", "lng": -71.1952338305713, "lat": 42.34690845297784, "height": 213787, "hash": "0XQR1wmeqRYF8BeIPLtqr7ZZQHLWAg7CavmKPrSxF8w", "fee": 0, "challenger": "11mxTwhQVMS9o5GqaQ3MW9NbJeQM8x89e52YG3Em4turgAHPSgs", "block_hash": "XcQXEO8eeJeCQ1V6hcCBMH06a1pOZXxrUBp-2NhM8Yg" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEUCIQCUJskKawMwc9G3Uv_ZRYrhSrHo4QoNuZT4amHVS3rkmQIgJ_RZ-9z3v9T5JNwnAtDTynwJpqO1cQ3KHPBeFGxRBQY", "secret_hash": "B7scyTy8h6nsXymcrXPaCt0MShUGki2fvPx7lsmRkXc", "owner": "13Wjb3U16ct477Qixg45nWEtRh4Jg2qTp2iuqgD2Adk8gQmF8Bo", "onion_key_hash": "1xip4moxB5lx8UO5Dwo35ppMfJi_ASSgxsYaLPaHLRU", "location": "8c44c13164947ff", "lng": -84.23063101246672, "lat": 33.85883850690923, "height": 213787, "hash": "6J8ZsZjDF2tiStMOVjtEG9jaKnpLZfAwY4jXx9bX1y4", "fee": 0, "challenger": "1181v5Saf87iUexQ8WtqA6xLrzbuF2UaS6dGY8R8p4yqoK1ZjMA", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEQCIEEk2H6NFe9CY7ZtoPPr-9cyBDuDCTvrOOzKpPW7ldIAAiAfGXSl2cgqtVzN8um0PyCTr_dD8_Gmp2CwL8SEkuv1Ew", "secret_hash": "zCA4W7sUqVu6Gzpz-5TUbzxTTv8SbY0B74VCIp46Hys", "owner": "14MRMNbNQidNFTszjoYugvMPxQLqLoZyPADSwJKvvnzgd8UX2UZ", "onion_key_hash": "PyGkman-6k81fdcQn9_DS9dJLRo9r4P9ijpRxPnM4-E", "location": "8c2663d04684bff", "lng": -88.31876752603684, "lat": 40.10013118277986, "height": 213787, "hash": "_aOH3TaNbUXB-aETIk7bsUyH6p9HOWDfx3P5wXBxnQQ", "fee": 0, "challenger": "11K6YeKEqfwMJu2wy64YHdQhXT8Hy5aMA4SxFdvCR4zwQyF17Xo", "block_hash": "znLXFN1OaN6aosWTZRmpZ2SIu0wiT4LKG3VkDpf8oqA" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEUCIGCf9Mxj5P9aeuIwbhMrGkhVORX9ymsditZ8jwgrRGoTAiEAmv6oeps953HnAGjtW6b7yu6gKiGYDXneMJxOPPX5cN4", "secret_hash": "otNY8AVs8_JsIay-CA5XXAiKInVEx00lwXnLBIAfWKo", "owner": "135qJwSQD2eFBsDjcDWKRgJucKRocVLvxrunc1W9KhcJe9CAp4G", "onion_key_hash": "lEEBV1DODq5iFKYq4h6mmb-Oba-6dcYfQ3cMUjFhxHc", "location": "8c2a107a90b09ff", "lng": -74.21400962950572, "lat": 40.68133174681411, "height": 213787, "hash": "AqLEUGRylc9kfW_tyLMwTJPunVXmlqh5ZrzYVUWxBIE", "fee": 0, "challenger": "11cpn65Uuugxs9YAAvYc1i7J9xgWY2pjSj4Y2FFvaFypa8bccLq", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEUCIGPQZRXlxMMJXAiOyYAja70dC6HihyvXNoDRTno3Rw7gAiEAsKS_4qaQ0zLf42sW1SaLnqfb1mUquwFpHbU0-lo21yo", "secret_hash": "CZjCoW6RU6TejMQjhgePVXPc759u5yp04Y9z5ye5C28", "owner": "14gaNAfNSL8pPAVjTyy8LhRjVgw9t8JunooEmCSyXLAX9A3pfMF", "onion_key_hash": "mWsd00ByHhfa_2J-CpphhbhSIiqg58_tMiYkoOBEU6Y", "location": "8c2a340910313ff", "lng": -70.2707016518933, "lat": 43.655908895594315, "height": 213787, "hash": "bdkRW7Dxx-ESPSz7i_vxk-jXIqUfmFL9pZUWYmJOwYU", "fee": 0, "challenger": "112u5QmxT5LVrD9vdtT1hJ7bBEdqthhbbefTaNK1JCS5n4xbKRoo", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEQCIDDdF3MhXzgLzVRHi6-x55ASjv9BtbIneBMyGekAThY0AiApKRRfmZRVYt-7Bx_le9uaUmmWYkWPv1IXDXRgCGR1Ww", "secret_hash": "Upa8MV8OvHZBddL-GLAyeNTJ7P80vTAxYFsTI25AnOk", "owner": "139fiM2t9SGU8yB1QG5GxRy9qztpcnjr1F5u7Paop9Lsh7G31sn", "onion_key_hash": "F2lzKJQyFet4zkgVaqR9FeO1i6SqICpaN5P1RfbM07E", "location": "8c44d9975282bff", "lng": -82.72848196624813, "lat": 35.533213738889785, "height": 213787, "hash": "c-6u-jO4YX0dgxXSUMK7HKxdPUmxbxwXCbHblKDbHjQ", "fee": 0, "challenger": "112oBX3SKsRdxXD97dNVL8k5ejnS6bYiKxjWeRS2yuj8gCkgLUb1", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEQCIEQkbbVN05yp4ynRKCdnXbPBOADm645fVXXg3wQ5EGgJAiAqO__gcfiLdmPqtofKvf1XAnXL6oyTe2f6YSIkatGfMg", "secret_hash": "0RusqDuS5D1l6VxHHqOfYKN3_dRzS9glMuv9XhlHJOc", "owner": "14FrS6JfobouRDVf7FbYuvvR5uNzB688qESpQNXLoaCqd1zDN7P", "onion_key_hash": "VQuQlV7KfjAK2xT0CqP6a-qt_sZHBD5AQKeHOiSRMeE", "location": "8c2a122dbb893ff", "lng": -75.27858120362838, "lat": 40.236503579574276, "height": 213787, "hash": "CGjUzaSOqukYqnJK2zYd0YuvGea0MrNdlRCubhEPbag", "fee": 0, "challenger": "112a5Mzuhw4h9Er29yGhsYLi9FePQmzmgyKXZW53to8uXHzZYSS3", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEYCIQC0VJsxXtXeYR_NAOtoFz3C-tbOam3sQFKMAyufH0RdGgIhAKK0BBiCJYOOpDVikt1jbxMUscVz9q3gRTrw9ga1NNJ0", "secret_hash": "30jwhK8zdNvluN4ikCymnWo3GBwYfyWk1fALTBFYcHU", "owner": "13T8w9Y88SEqbuzRkDq49xHKfX57cJbbv5y1fTqMU79Wu1q1o5j", "onion_key_hash": "1oYPe7schX1Ph2ZpP4zGGOviXfBLoZlF_WK3usuelac", "location": "8c2a10564c437ff", "lng": -74.03002342945634, "lat": 41.04224197668894, "height": 213787, "hash": "E80uoOjygu6SbUqsnEu-lCXKjbzZW9WiHSrKx033-MI", "fee": 0, "challenger": "114PsNUa1rMT9Q2PpeAqs9RpJXjMgb5BNT5Azi9CaVQ6daijLRo", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEQCIBYBRSno33FSUpXXZnMy51MK9ciU_MO__wWl9nk7UlLqAiA1OU26vJxQp8irF6NpdqPLynpTMBdTxSgEiAYTcr-0UA", "secret_hash": "G7PfwPRmL5NFwtVNhAA3y9F0-6_tfKLeV7Vq6fLUOEY", "owner": "14RhEs3bVE9WYryYjdBG3LksJVhd9Wp5fxPLRQeHebTrPKReeyE", "onion_key_hash": "miByk1ioQpmSoSlLmk5pSlhnoQHdK-GXZGsiNJQSvxc", "location": "8c2836156622bff", "lng": -121.02718668572189, "lat": 37.65368378785006, "height": 213787, "hash": "eLaP-eUAJbJJIQSIkb3u5wD-eQMjJ_qeI-zF8YWa-7o", "fee": 0, "challenger": "11F2cGbEYfB6qvmNLE7tXWnkgqLfWPvHpxsgyghNRidusGDKD41", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "version": 2, "type": "poc_request_v1", "time": 1582192928, "signature": "MEQCIBDls8CH7DspVWl0IC77XLzzt7wHygTukGlibTygCP3QAiAl9fR9dNgLgaSIkl4cqBrSqjtbtu_Eg1UeMjRqmi9mog", "secret_hash": "SR-livfqQa58lN3WX5a9jIBUW63DFOUUAgCC27WRu6I", "owner": "13BPvTrw32jdsBPJYnL7whYghwLboCqipTaJbhSEaaZVzgmEemm", "onion_key_hash": "R9GPq3ssxi6LW_iuj-7KqSwKSmZ_in7EdJEGWcVrWbs", "location": "8c489e3534f45ff", "lng": -97.68010436306147, "lat": 30.30448054652587, "height": 213787, "hash": "eMNvkAotMP4e3xAfN1gh5oc5CTXnIhf2sIxijE3oZXA", "fee": 0, "challenger": "117r6sxGnFD3n5GnMTqSfhLxYqoXcDvFpzjNkweD8ZhPr9YQLRU", "block_hash": "aCrKSvuKX1dAkUURkvaCRT1C0Z-WD5m6q4TgWr7gx5Y" }, { "type": "poc_receipts_v1", "time": 1582192928, "signature": "MEQCIGVhWn3s3_2HYQzGNFi2GmV3xsr8Nm2EemoHNyqPNb33AiAPOfTXQKEo6Ol1H6JnlNTihUDpK5qtVRM6JSEDaVNvYA", "secret": "AJswL6q6bm7bGIwk3jzzyH0kDGSJHb14ZnI2GgVApo8uBC3mU933j0w0_5rF3ejIZdLSusOmCZdzhoag7RtADi6OGXHHEdRNfTIDYR_41sddC0mqPE8A3NXXo2mzpqqkgo4", "path": [ { "witnesses": [], "receipt": { "timestamp": 1582192367974227200, "signature": "MEUCIDD9BLjC_ghbIe7zhKQtDrhrlLD1BJgI_95ryQ6CFyyOAiEA1BZj_-faF_d7PFela0-EC6meWh3Wbe749I73Ta5gnyM", "signal": 0, "origin": "p2p", "gateway": "112oQLEtxFFw4NrPZ7d1DFM1iScCunu5xvea99kVVTorNo16cBKg", "data": "NJA" }, "challengee": "112oQLEtxFFw4NrPZ7d1DFM1iScCunu5xvea99kVVTorNo16cBKg" }, { "witnesses": [], "receipt": null, "challengee": "112SVQqroQvvq2rQHKWYfxP2eRb91NLXU8qduBCLt1B1DmLK6Xj" }, { "witnesses": [], "receipt": null, "challengee": "112CGr8XwCuHtD4CmewgCWfz6ttQaRLK5Up8cjoUng37zpLN5kbi" }, { "witnesses": [], "receipt": null, "challengee": "11DpearQqzUSCy4Mdho5CN4LSqZffhHkAwkeRieeAvELnpQzfUP" }, { "witnesses": [], "receipt": null, "challengee": "11DRokFJ3U9UkDU4BFN2djb6fH7wAwLr2ysXPJsbhDoUoyGFvuV" }, { "witnesses": [], "receipt": null, "challengee": "112DWqhAqCd5ie5sbSxXBG7o3mrGZgPSdhEYumbvxSNA4G5ZSxNe" }, { "witnesses": [], "receipt": null, "challengee": "1125H31qsBackYPLiYQQYHvxi6bRxzcfjRK5aJv1gA2ZwKb7WYL7" } ], "onion_key_hash": "qDnv0zJGjHUvgZTmGyJspRiPZvktTqQ-enBE43xrceg", "height": 213787, "hash": "GJMR4wfeHPC2xBhGM4vQqu344dyQdn7TZUpzNFu3baA", "fee": 0, "challenger_owner": "13uJVUm1U2iFZHhmFNp4E6L6v9rkjoABicw1SFC424rqadj7Qg5", "challenger_loc": "8c48eba0b2d11ff", "challenger": "112fpjqDuU3MequG617EuQ3xhtdecz6ah2WxJK87XqfHL5jnSdvc" } ], "cursor": "eyJiZWZvcmUiOjQzNTIwMX0"}optional

List Accounts

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

Query Parameters

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

Response

javascript
{ "data": [ { "sec_nonce": 0, "sec_balance": 0, "nonce": 2, "dc_nonce": 0, "dc_balance": 0, "block": 435239, "balance": 0, "address": "13etjTqyGLK7WQh8pp9VJy5ejh5MXmwFee2eAi3TfAA5kS1jEJb" }, { "sec_nonce": 0, "sec_balance": 0, "nonce": 0, "dc_nonce": 0, "dc_balance": 0, "block": 435239, "balance": 179087000000, "address": "14Xg1SqiJDsmM2YvchR4UacevcuxjfyrjdyNEpRMmfBU7vrZba9" } ], "cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"}

List Richest Accounts

Returns up to 100 of the accounts sorted by highest token balance.

Query Parameters

Name
Tags
Description
Example
Type
​limit​
optional
counts to return. Default 100, max 100.
10
number

Response

javascript
{ "data": [ { "address": "1398hLeHESZHE5jVtaLAV5fdg2vrUeZEs2B92t7TzeQTtugr8dL", "balance": 616416488712965, "block": 489719, "dc_balance": 0, "dc_nonce": 0, "nonce": 3, "sec_balance": 351543978600, "sec_nonce": 0 }, { "address": "14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S", "balance": 292033864604925, "block": 489719, "dc_balance": 0, "dc_nonce": 0, "nonce": 0, "sec_balance": 166398670100, "sec_nonce": 0 } ]}

Account for Address

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.

Path Parameters

Name
Tags
Description
Example
Type
required
Account B58 address to fetch details for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
text

Response

javascript
{ "data": { "address": "1122ZQigQfeeyfSmH2i4KM4XMQHouBqK4LsTp33ppP3W2Knqh8gY", "balance": 0, "block": 311833, "dc_balance": 100000000000000, "dc_nonce": 0, "nonce": 0, "sec_balance": 0, "sec_nonce": 0, "speculative_nonce": 0 }}

Hotspots for Account

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.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "lng": -81.70707772367822, "lat": 41.480133219396784, "status": { "online": "online", "height": 435166, "gps": "good_fix" }, "score_update_height": 435153, "score": 0.9222412109375, "owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx", "nonce": 1, "name": "sneaky-violet-penguin", "location": "8c2ab38f19a43ff", "geocode": { "short_street": "W 32nd St", "short_state": "OH", "short_country": "US", "short_city": "Cleveland", "long_street": "West 32nd Street", "long_state": "Ohio", "long_country": "United States", "long_city": "Cleveland", "city_id": "Y2xldmVsYW5kb2hpb3VuaXRlZCBzdGF0ZXM" }, "block_added": 96087, "block": 435241, "address": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB" } ],"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"}

OUIs for Account

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.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "subnets": [ { "mask": 8388352, "base": 0 } ], "owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc", "oui": 1, "nonce": 0, "block": 762440, "addresses": [ "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE" ] } ],"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"}

Activity for Account

Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "type": "rewards_v1", "time": 1608741833, "start_epoch": 644049, "rewards": [ { "type": "poc_challengers", "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB", "amount": 8423208, "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx" } ], "height": 644084, "hash": "6A_8hid6ZIiyg32dzQwFajM-iDyAvYJdVccSpxyymi8", "end_epoch": 644083 }, { "type": "rewards_v1", "time": 1608691560, "start_epoch": 643255, "rewards": [ { "type": "poc_challengers", "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB", "amount": 8639175, "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx" } ], "height": 643353, "hash": "jd5mq1OMG1q7g_JNJr5gFHD17uMSawvFNt8ARty2OGQ", "end_epoch": 643352 } ],"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"}

Activity Counts for Account

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.

Path ParameterNs

Transaction Types

Append the version on the transaction type name, eg: payment_v1
  • add gateway - Add a new gateway to the Helium Network. For the purposes of transactions, a β€œgateway” is the term for a Helium-compliant Miner that is mining and providing coverage.
  • assert location - Assert a gateway’s location on the Helium Network. This happens after a gateway has been added via the add gateway transaction. Once asserted, this location is then used as part of Proof of Coverage challenges. A Miner’s location can be asserted more than once but each subsequent assertion will a) cost a fee and b) reset that Miner’s score to neutral (.15)
  • chain vars - Change a chain variable.
  • coinbase - Similar to the bitcoin blockchain’s coinbase transaction but used only during testnet phases of the Helium blockchain. The rewards transaction has taken its place.
  • coinbase data credits - Created the initial 10,000 Data Credits required to bring the first group of Miners online.
  • consensus group - Marks the election of a new consensus group, responsible for mining during the next epoch.
  • create hashed timelock - Creates a transaction that can only be redeemed by providing the correct pre-image to the hashlock within the specified timelock.
  • create proof of coverage request - Submitted by a Miner wishing to initiate a challenge.
  • data credits - Burn HNT for DCs at the current oracle price and deliver them to the target wallet address.
  • genesis gateway - Used to define the initial group of Miners that bootstrapped the blockchain.
  • multi-payment - Used to send $HNT from one wallet to multiple wallets.
  • OUI - Create a OUI for a new router on the Helium network. In the Helium blockchain, Miners forward packets to Routers that own them based on their OUI as stored in the blockchain.
  • payment - Used to send $HNT from one wallet to another.
  • proof of coverage receipts - The result of a POC submitted to the network upon completion.
  • redeem hashed timelock - Redeem the transaction created using the create hashed timelock transaction.
  • reward - A token payout for a specific event on the network such as submitting a valid proof of coverage request, participating in a consensus group, etc.
  • rewards - Bundles multiple reward transactions at the end of each epoch and distributes all $HNT produced in that block to wallets that have earned them.
  • routing - Update the routing information associated with an OUI.
  • security coinbase - Distribution of security tokens in the genesis block.
  • security exchange - The transfer of security tokens from one address to another.
  • state channel open - Opens a new state channel on a Helium Router
  • state channel close - Closes a specific state channel on a Helium Router
  • token burn exchange rate - Change the exchange rate for burning $HNT to DCs.

Query Parameters

Response

javascript
{ "data": { "vars_v1": 0, "transfer_hotspot_v1": 3, "token_burn_v1": 0, "token_burn_exchange_rate_v1": 0, "state_channel_open_v1": 0, "state_channel_close_v1": 0, "security_exchange_v1": 0, "security_coinbase_v1": 0, "routing_v1": 0, "rewards_v2": 1082, "rewards_v1": 9180, "redeem_htlc_v1": 0, "price_oracle_v1": 0, "poc_request_v1": 0, "poc_receipts_v1": 0, "payment_v2": 16, "payment_v1": 11, "oui_v1": 0, "gen_gateway_v1": 0, "dc_coinbase_v1": 0, "create_htlc_v1": 0, "consensus_group_v1": 0, "coinbase_v1": 0, "assert_location_v2": 2, "assert_location_v1": 4, "add_gateway_v1": 5 }}

Elections for Account

Fetches elections that hotspots for the given account are elected in.​

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "type": "consensus_group_v1", "time": 1608276577, "proof": "g1AAAAdHeJxF1Hs403scB3BWZIdDuQxzadTRcctPSO5iLqedI3ILMwxDmEs4p6whSTEqyrbsnCNMSCObueS2Vi6VS3I8Cp1OF2zusllhzvpj_PX95_08r8_n_TzfT5yEhMT-aFC86NGRwI9ayb7Ga3lcJh9L0qTkHXXTzr0HL1YSTO5lofGR6DvfU26AC0hHgrZ968eJF4KzjfhZcqHsq9FQiDbfIAwZfzWO-s_GSyQPBAvu9PkmlT5U4SBpziI1YK9EZZNrZzy-DTu5_5CJOQs3E5urJbDq5UVW1ifX0s4CqeduzYBzvw3lRhcgs6cOnA_gxCbMc9tU8TBXcWLDXmi0gL6kKDtqbvXA-ogHm5asq4k7ZCCaql21vQnp98hV_8_Fr4duN7XFpZgBi3gpKWX-pUDV95mqYjPOIv55Q-o2CpY6NtDeL2ArzIQQaertsFGjA8cslzmGO2YGvmH-Yf7fI3OWl4suvAxyOf22kK5tdOpnrvq1WdL21UqRWVJYZsJcCKoO13N6qon3DfCOfbJWHBYRN4TunpmQnbQUm8waaIO97appqLcX-yr2K7-LPTemCkvKq3ceP7RWA_HbMR3tsEfzvSN1CcoXx7D7KsMfMytU9yAXN7jFjqiCntu2IvNNzrevvJCbuNx2_mjSIjViwd_n2eCyCfCOmOAyBa2-JDYJnh82U4tyAGx2R4ulpFvX6B-NMYbtcGiJ0mO4xrs3WzumkkabPiGELzE-ciI7mQzgpnv-m1kCy1sfTy5A2ASXhYrMvhwBPD37Sm-JxMHgoG71dORWfxPeawaTP6z7PsDmk5rY_IHoKL1pO55BYGk_dpf1Znkaadw2-2Mf0boporKsu1ZuxzQn7g2P-sIFC-IpaPDWPR9gJKXup6gqoWkgO2jmRO-GyCQNIkiOLTJqbbJawFxa8786Foot8heF0bqLf8OJkQeWxKbRBy6mQiNxHFcw88C-3Z-gAyWjDRhJMdG8giTcEtPhe8oVgINgGrg6qI1ePUHtnLK3D73xLcbjdzdml9C42EKh1nPl1HkQzLq17jM_uvXHSsMi1uz8sTuJZueuSWZJywG_XWCWGyg6icktzBKcONINuS1EaBK-GDZ4rTdP3al25FmT2F-mafJV31PugKtoiQ0TOFcbFd6pwZGbBrPNnF9PMko-eCebTrk4dfZK6N343u21EU7xOPXVMCjjs9qiuhmwdn3vSUTfxK2zMiCi3QpEjP5Ll8su_GkPZfDyJatwq9cJtCs1KgxlSPkhJU4Um1cSstPtea3fwPgulyjrDNMIVULwfbPkWd7NM84G695IQWl3spbIpKZUXbCf3bfFA1B3H4LnSa2-vneHQy1cqz9rK1uknbMQm95BYPq9FOwZ0MJH81dHL5yW-vi0z9lKf8XPv8PDONtauHsTBnKGgAKbesgpbaU3jV9ttc80evnbOHZa6dLT4mgn3kJBMB_odf0y30wHGgB1LT2-UF-rz94_tOWe7m4WIwUJ9xGITVAgarxJYRpMVoupGS4mDef1DGRhOlKsuI9PnbZ-RNLaLXcKNdFzFHqP4WGy2heByqzm2hsvVdk9H2SsliLuXzzsLIpURQfWD0qvZabH5BXue3knB3er9KIm8_ikwn7I3LpJkbsY9eosDPVrApJ0wmdM0yq3InI9s5ZWY8OWqyzdYpB-NMEumptHf9hYGpXLw2EKKzL3q6j4zyrYTFelum79XmyXVnNCFLmV7vICT92kv6KUy9ycH7FTiaNFFjVIEEKiZt87vCiPFaMK_LmR1z4wAZ91TV2BQ1N6hm0ZW_aV1EL14Jrjbbs4u-0O24UGxGxWAj8fDGzSIHZQOj7KM39t7ZmrMJdjLVAYiSBYEg08GvqA8d86echrm9e_csw4sQeOQK_HCGqFe36R44jNywNZ_Hya3wirsvhu95DlmCHHJEt5NjJiOwHNTHiqwdv5LTIqG2VCLQopt41atJWKNMEi2uyff-gNroh_NJlYiMCCYAeaVB16GHW6BlRtB5sznF6VAMkKsnxTUlg1yog-bf5UTPp-mouFdgSYdrBHMQwNIoFYN57qLx0Ad9p8EtHP15_bXZOkgz_4jnukL-PPK-9B59dw6w4v_agIP4uPnU4HWzB5BSAYzLWMyA0bpkc3Q8DKSa3LA88SKjawieRVXBzaOkx6XmwiNxv0INkrD4nBb2DMFgKtumWZ-m5R7y9MWn6vXMeA-u7xO2wh74gLkgbL4KjIX5PpTHQ6AvRWQe1RF_j8-I2VRNFUtUPsctTggyP3p4ztVQWHIREnO-ueFMVSLC0Hrpd_wgjP_Q_ffiin", "members": [ "112qqYc77fYcGLYrD5Bd1zG1dwoXGCzaQ63oby8ws9mhDrhieTRv", "11hxEKmhr2xgVu8srSdkmoQYNVYYKppKd82mtanBbU5kd9r42hs", "11LmZdUgSn5Pwa8a2Q16EUDfyLutpDeQoUgzgerHJc73p8NTC3V", "112374TV64PVuBDDArCymuiqA6AQdNr3q9JVthoYo5r9kBCS6N3", "1124oBcVaT6pubZWxuPisQs8hNKaYp9cduvQ9skcpRmt14LnhsnX", "11eq43bdC6iAsQJtSsxbEwZZP9ECZX7QYnWXn95uc3Ajym9bdP6", "112vbpLrhj8kQdBn8FDBYR2KcXVh95HmPfgyZfuA8kL5kRKVEWyc", "112hX6sPHCgYXP98tdac5TqPNfU17t3K8ZwdpLd1UfFSD8Xoqv3H", "115fXeCtfk9FjpoNXn8QCikp1GVGgGg2S5BXq8RJovcDvFrXrL8", "11xrgEdiN9DA2cyauB29AXDy8WoMEwhqaL1chU83YWGx7q81sp8", "11d13u5TospVvAD8pGCYNZR3GrEykB4osswni5fcXnonfHDSEpG", "11diD2YbFNJ4yHDoWZpJErdJmwRsGEepCteEHfFMwakrTxjvMRG", "112PSpVub6tJxekGMF4N3wp7Yb883pPWiF4WCw9BeuugXJucGZqB", "11pf3gLhyFPRCedRPngEUu3Rr25sRYi16WRRS1ZYsA6hGMpkaXU", "11zcBW5mQx2iJbNUg3MhvUEVbnB7Ty4dFL7Pgt2qvENZiNSotuV", "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB" ], "height": 637456, "hash": "mKX9qDdsbbHfkllXZJPmDnaWftsHeFxodSfyTPTSPMA", "delay": 5 }, { "type": "consensus_group_v1", "time": 1607829748, "proof": "g1AAAAdAeJxF0nk81IkbB_DxDZspsTFj5PqOa8XkmoZhLIZhpNySKzYy5Mo1SGKw5MiZIwxlI-YnJqac5UghlN-Oe2VD_LDGEZqc-emPmf3r-efzer1fn-d5_CEQiLAPEHA0kBAh9jJzyB7cZncmiwst1Yq8DWwaXb_MI-XWHd0YoNe-9CNlqk4AQAOqgbh50QFmI5Kp_3VTCXFyOOmbrs0pmt1tefcoKm82AGKiy_3Lr8_bmZ1krVea5ZI8WG6f0ZpN45I5zGCJM7pwDqmCLqpGZDWDY51dzX9IxooIRVS-C7vl-vfIaFR6-zQ55kfKTN0UQEIWYmPn2HE_X9VlwqvHpyEU0TXGUzquVAvVYf3wsmWW31GkTPDM-mQwYz1q-3mXyUcPwsxcNK3G4r4w_p-B3F0h4zgOylgDzjfx8wvwLkbYlyB08Gnza5jJtRcDend7JyMe1m5xe2ram_Hgf_uwTVGr6VNyoWwKUij-D0zmbXpZ6jTcBVseAAzB3kg77eq_FzD_UhtDlihEiRqv89992AwPn8A7a9MdOGRzptCrxy91zFRp29WOSS9Las9lftTPXbXqPrco75cKq-OS0Fq4Uv59Z3mPnZTcleE0JHaAkLqbLmqNeGCbiVwtqAfAIHP9Te1Cvs-GKLV7MpJTlinzLFtrTcQMIuep4EkXArflAY7xrTFD5aGyBk9JlKT7PjEbfrgTautxwSWF7bTr2PMjRVQ3AUBDimV_3tn2WGxseW7VqgI8attd-8NysMvX8GLUtY3WhaPN1hLn0svarhokH0KGxiPZPzVgze0QEdCE4gUFmUQfnSKOKVf8Aj2AluEF0oYvYuXqQkdLKqETig0nnj_plJjwCV7imp4dQS4336igMhRUvl32tz-t3Nq6WZ-b73BtJ8rO0YqVf2SuTGNJyAPlDvtH_SfNvd5q1PMcOPJn3RpBa-ChqQreORxzh68zaOubbyGx73a6qN5u_pdPnR-Dyn0TparvMFBKsBzuaiXv8H2JjOha45-JzhIND6wzPz6ncvP5TT_cMgEu_tgNB4AK_ego2nSIsDDrU7j3Y9jGg_Phw8GvWj7oxruZeSrqm3NIAatLoVcrGKWk-KfP5a3yvKpijdoyQv35W5LDyjv4q_r__dqhzrkPTnVSytmWj1U-7wyZylu80Y2GkmLRjNmumRMEp6PIX8fIzdTj5Jmhcniiwb2oQPk_arZaPIstsHVO0HwV3rMc9CI58qpmSLUNRqnooEjv2UQTkneS7iXo6vyxV9dgPIDK7WmUerPmN9n3S-6xZ1jltnp0_lnZhEv7pe6D0LYeq0IbBwB0qd1CXBr8UnvhzQhhr1Slqo_pYrkHTaMJ-GhbtOvIZ3DIXwgNi9R7OOFJI5K4qOkTdcuznSsLX8BG_aS0FTjLNPDfno1jsnNxIh3f8-OW70rTM3suHuxXaOiHGOQJtRh6JZitH0V69bYrYnpo0rqNWXggSBslTdQ8rQCaZFfGA7t4i20ZDvrsUHWYHWm4kT_rqfqoi1iHO7Vh_bt48s8IvqATbPGV69wfso1eIkt00MeV1fbwKdRmI50_8Q0nNmNkzTKqxLI6Mm2PzLGY0VZ0PZg9cAPULAElRu6IGOeEA3KwGUNrY7_DUirHFJMuel9RSjVnrGOKM5PsVh2anXa8eeuQRp5kknmF7VOOiYTMZq1mrLSL5cV3hyWUFuQZYlIUFwcnZn-KN73xH74h6SoAlLq898Ak5J8GxRZFy8lTG2nvy3K0pJT1AsoiBYZTjftCOKZSmZ8yOgV-ilgRoa2Gp4XtetiEHgvW0j004UMGer7Dcu95B0lyGlAM1rxPQJPqnVFeJCOpqA7XwoQYXPct5lDzAACam_oCC8eu9ZdVv2AGFfye_exKmKVWxmgihrgtbDYFQ3FIG4B9vQx3zbbO74WqGnn_9WvcFciIxpi_tNUrbMrfrx9xSQ1_9dv0OSNHFZrlse2xiK24830JwRTK56mIwEGC4T4fABJXFb_nYNAW00liuZVNWahxjRqtd0bQHPFLfoycniuqHHL1vXhFsuMmHe_EU8D4n6RIcUlvYxvsL3kHCoM-iQA-cUk3I1bGlunaV797lD9fKX8iEKckL6Ql7MxGqvlA1iMFCwDw-JNO01vjNJu8aWavmOi5g5Bfy2Gw0NGhROwYKh1848khjxML5VqboXJTNd0YxjyZ3lutX9Lx_S2MzT58AktOGeCSUisTiyWPfsnM_69vFtXh12mDLQR1efCcjvWEzJhmG2oZAFHrGz6uMW9nyry_M1lht8E2byY_yeXQGaaTKitAdlHz_T_1TBOF", "members": [ "11GgZk795fcucYYaCz6f3iXJpR8iA5FVBJFgYzFbdeciXVacrke", "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB", "11aEVjsaJN7gfjggGvFuGEgixQVRtkWzEpzX15YHiZJkLSsuwdv", "112Lx9Tren485XT7PvY7GHnmUVMTvyjwZ6hrxL7ozeDvqE7Jy6pA", "11L2XXdnBjVmJiyb86yLyhbkg75VYEjSx9D6qMKYdsS3mnJzXoS", "11JtrTKA3wGNE2Fgep5HLC2B3YTRDsAt4vNc7GEsVp8Y7nYKGz1", "11JJ4RR6oPbpVouU1rzkRQC9T4VavDZrbbPaes8FVoD33uyxHQV", "11cgLFT851vXJT4iAno1G89kct7qVM4H17EYrbJmZBuJhAyuvgD", "112vXW9jvfNKVzWGfMYZhEmBxbGVro5iNZmUWiermAXgRebac3Pa", "112NFATPKh4y7dXudyM9NwFwxzoLYHbX5eFzMjbQtCXTnQJrL1Ze", "11BBZMfB8c8L3V5YVQ8KSTsVF9gx5HFcDyB5c2S1E2g86w7UPdc", "1156oi8swcmxmR4RGM7fGHFA2JP4Lk4UjXL11tcxZQGCqfh58Po", "112tfwpKvCqwDfzsfyAnQwj7gbmx59zKCKDaxBsmCZ4pPBd8Gasv", "112QirNzqW2LuGAuorXA68mr9qiuWnaEALFPkeBi5AK5S5gccRjS", "112pArcjJA6mPKAFVifkK84YVkVUro5iWh2TSbTwBcV7xrsyQyQ2", "114eVcYfr3ujqUGsEKs1pJQQGAJTA5Lf4JgG9BjVmKnodr41Q5q" ], "height": 629706, "hash": "c8gPYHwWpEGHMLhDynUHHw1k-qhW61JBPW8Q4kTlic0", "delay": 5 } ], "cursor": "eyJiZWZvcmUiOjQzNTIwMX0"}

Challenges for Account

Fetches challenges that hotspots owned by the given account are involved in as a challenger, challengee, or witness.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "type": "poc_receipts_v1", "time": 1608740853, "secret": "AEGM923859xCnALUTWtVzYIkRKXAL4E0Ss1JRchMhhMdBOhuXOob79UwlghHhEZN2ChZe7vvnltg8Z2D-adlb-kkL-hv_ONvpcsFXPw9y_LYzIwTS7TAIVbqKfuBn_IVRcc", "request_block_hash": "JTUr-_hX--L6TuwIkx-DEzeB--yMheo2Ud-yZ4LNVt4", "path": [ { "witnesses": [ { "timestamp": 1608740090285495600, "snr": -9, "signal": -100, "packet_hash": "p2ZijVno8DHGJui_bV6u-tABHQOiEB_c3NCFOv_-1xE", "owner": "146MwmL9eJJCdrykbgdL3dobdChP4Ut34mCZMR3Hv9HXTeBJQzC", "location": "8c44a105ca1d3ff", "is_valid": true, "gateway": "11fJaz1xwA2Xh1gQQWRh6FzDabEPkLs5bSMdDnSrb4CL1L5Y5Su", "frequency": 905.2999877929688, "datarate": "SF9BW125", "channel": 7 } ], "receipt": { "timestamp": 1608740088868575200, "snr": 0, "signal": 0, "origin": "p2p", "gateway": "112V5U5MSMVBDTe6cCzWEXzuCbjK96GbKXwDPFSCyjeVnL3wHk5L", "frequency": 0, "datarate": null, "data": "5_w", "channel": 0 }, "geocode": { "short_street": "Leslie Dr", "short_state": "FL", "short_country": "US", "short_city": "Hallandale Beach", "long_street": "Leslie Drive", "long_state": "Florida", "long_country": "United States", "long_city": "Hallandale Beach", "city_id": "aGFsbGFuZGFsZSBiZWFjaGZsb3JpZGF1bml0ZWQgc3RhdGVz" }, "challengee_owner": "1444k99dYKjngxQnqGxrB3CmqaFdGzPRWsxqbbu3LjjCyBocGhi", "challengee_lon": -80.12177083059214, "challengee_location": "8c44a10564825ff", "challengee_lat": 25.9903614158387, "challengee": "112V5U5MSMVBDTe6cCzWEXzuCbjK96GbKXwDPFSCyjeVnL3wHk5L" } ], "onion_key_hash": "I86cUPLZ46naXW6IFhhXGVFeKftMi4FhtpsJwtW03T8", "height": 644070, "hash": "Z5yrO_XbwTT89xFjA1_3OlSke1KmkJ7VZmigd7NDVk8", "fee": 0, "challenger_owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx", "challenger_lon": -81.70707772367822, "challenger_location": "8c2ab38f19a43ff", "challenger_lat": 41.480133219396784, "challenger": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB" }, { "type": "poc_receipts_v1", "time": 1608739733, "secret": "ABCXJG0PUoO0iyTzvmd-XPVfJdPW3HBztPWjld7TLvOtBA-1qOjN6UNWkVmPp69FkUrnqZmJr1Zz-H-4v1lu7HGaABQ0p3X_Ge4hNZ6b2SpijiqUYf7i9JjgxzwMUtvy8bg", "request_block_hash": "pO2v0ZyCEOYRZy7SXcsb2fGvTvfYRUxAlz4NHLG1H44", "path": [ { "witnesses": [ { "timestamp": 1608738987154888200, "snr": -11.199999809265137, "signal": -106, "packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis", "owner": "13s2SCJbWP9ZmGW5uULCehV7EJRDdYqLrmNCQCtoj5Y1RDerZAq", "location": "8c2ab38f1d5c9ff", "is_valid": true, "gateway": "112GGQtavNrmWhEoLd5ABF1fbfXLccS747ez1dZHoh9TvgjJw29p", "frequency": 904.5, "datarate": "SF9BW125", "channel": 3 }, { "timestamp": 1608738987176681500, "snr": -5.5, "signal": -106, "packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis", "owner": "13s2SCJbWP9ZmGW5uULCehV7EJRDdYqLrmNCQCtoj5Y1RDerZAq", "location": "8c2ab38f1da8bff", "is_valid": true, "gateway": "11uHyX8PJhk7kqRiW2JaF2dR2PGVX8vB7FcQXVW6M1rY2BbuQHU", "frequency": 904.5, "datarate": "SF9BW125", "channel": 3 }, { "timestamp": 1608738987229829600, "snr": 3, "signal": -119, "packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis", "owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx", "location": "8c2ab38f19a43ff", "is_valid": false, "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB", "frequency": 904.5, "datarate": "SF9BW125", "channel": 3 } ], "receipt": { "timestamp": 1608738985817671400, "snr": 0, "signal": 0, "origin": "p2p", "gateway": "11nCHecDUTkDxMNfAuMjF8cev7bfoKetWj4Y1MWDoSstDGhbMSs", "frequency": 0, "datarate": null, "data": "W1k", "channel": 0 }, "geocode": { "short_street": "Bridge Ave", "short_state": "OH", "short_country": "US", "short_city": "Cleveland", "long_street": "Bridge Avenue", "long_state": "Ohio", "long_country": "United States", "long_city": "Cleveland", "city_id": "Y2xldmVsYW5kb2hpb3VuaXRlZCBzdGF0ZXM" }, "challengee_owner": "13JyFksMcfyMTpycMy1XStssPWcQJut61n68sMUhG1cJQBmwUWi", "challengee_lon": -81.70946661837299, "challengee_location": "8c2ab38f56003ff", "challengee_lat": 41.48413978192872, "challengee": "11nCHecDUTkDxMNfAuMjF8cev7bfoKetWj4Y1MWDoSstDGhbMSs" } ], "onion_key_hash": "doMVn-c8K7SnduqUU4CJFGloUeAMB0pYRcOkTrAyt4Y", "height": 644054, "hash": "QKjdegKY_muFONmC3mbwKjlCP4BaR9zCsXZSanKQWgY", "fee": 0, "challenger_owner": "13hc8BeaE5kUiMYW1FLU8dnV4t2XUM4sWxHxM2E34NF3tnJdiXj", "challenger_lon": -73.93747871760092, "challenger_location": "8c2a100dc6dd5ff", "challenger_lat": 40.697659486078635, "challenger": "11eqcRNEgAk7vioFtgtTWUERyV98Vj5iDEm75YMbUCS3uaLKFXR" } ], "cursor": "eyJiZWZvcmUiOjQzNTIwMX0"}

Pending Transactions for Account

Fetches the outstanding transactions for the given account.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "created_at": "2020-04-30T18:13:17.411141Z", "failed_reason": "", "hash": "IUXgVfnYPlv_Br3Rhng6bKTaLb_AzX9DC3E9NGJhAKs", "status": "pending", "txn": { "fee": 0, "nonce": 6, "payer": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W", "payments": [ { "amount": 2, "payee": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W" } ], "signature": "TcB6zhMf6_ImaMyuTbWRd33W-hlzCwxxZtyIeJRQwUTvHN00V1U4Jn7ooyNHjFAoBgvxBDN2VmQ5Fez0OQoICA" }, "type": "payment_v2", "updated_at": "2020-04-30T18:47:19.960477Z" } ], "cursor": "eyJiZWZvcmUiOjQzNTIwMX0"}

Rewards for an Account

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.

Path Parameters

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).

Query Parameters

Response

javascript
{ "data": [ { "created_at": "2020-04-30T18:13:17.411141Z", "failed_reason": "", "hash": "IUXgVfnYPlv_Br3Rhng6bKTaLb_AzX9DC3E9NGJhAKs", "status": "pending", "txn": { "fee": 0, "nonce": 6, "payer": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W", "payments": [ { "amount": 2, "payee": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W" } ], "signature": "TcB6zhMf6_ImaMyuTbWRd33W-hlzCwxxZtyIeJRQwUTvHN00V1U4Jn7ooyNHjFAoBgvxBDN2VmQ5Fez0OQoICA" }, "type": "payment_v2", "updated_at": "2020-04-30T18:47:19.960477Z" } ], "cursor": "eyJiZWZvcmUiOjQzNTIwMX0"}

Reward Totals for an Account

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.

Path Parameters

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).

Query Parameters

Response

javascript
{ "data": { "max_time": "2020-08-29T00:00:00Z", "min_time": "2020-08-27T00:00:00Z", "sum": "176714898" }}

Stats for Account

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)

Path Parameters

Response

javascript
{ "data": { "last_week": [ { "timestamp": "2020-12-24T00:00:00.000000Z", "balance": 2726587598732 }, { "timestamp": "2020-12-23T16:00:00.000000Z", "balance": 2726579175524 }, { "timestamp": "2020-12-23T08:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T00:00:00.000000Z", "balance": 2726227814759 }, { "timestamp": "2020-12-22T16:00:00.000000Z", "balance": 2725942362517 }, { "timestamp": "2020-12-22T08:00:00.000000Z", "balance": 2725650289654 }, { "timestamp": "2020-12-22T00:00:00.000000Z", "balance": 2725147917954 }, { "timestamp": "2020-12-21T16:00:00.000000Z", "balance": 2724406718606 }, { "timestamp": "2020-12-21T08:00:00.000000Z", "balance": 2724056284882 }, { "timestamp": "2020-12-21T00:00:00.000000Z", "balance": 2723209316840 }, { "timestamp": "2020-12-20T16:00:00.000000Z", "balance": 2722951323859 }, { "timestamp": "2020-12-20T08:00:00.000000Z", "balance": 2722934379280 }, { "timestamp": "2020-12-20T00:00:00.000000Z", "balance": 2722897458808 }, { "timestamp": "2020-12-19T16:00:00.000000Z", "balance": 2722688076583 }, { "timestamp": "2020-12-19T08:00:00.000000Z", "balance": 2722582293089 }, { "timestamp": "2020-12-19T00:00:00.000000Z", "balance": 2722544226107 }, { "timestamp": "2020-12-18T16:00:00.000000Z", "balance": 2722495151953 }, { "timestamp": "2020-12-18T08:00:00.000000Z", "balance": 2720896037594 }, { "timestamp": "2020-12-18T00:00:00.000000Z", "balance": 2720485905293 }, { "timestamp": "2020-12-17T16:00:00.000000Z", "balance": 2719886473562 }, { "timestamp": "2020-12-17T08:00:00.000000Z", "balance": 2719278670960 }, { "timestamp": "2020-12-17T00:00:00.000000Z", "balance": 2719231394336 } ], "last_month": [ { "timestamp": "2020-12-24T00:00:00.000000Z", "balance": 2726587598732 }, { "timestamp": "2020-12-23T00:00:00.000000Z", "balance": 2726227814759 }, { "timestamp": "2020-12-22T00:00:00.000000Z", "balance": 2725147917954 }, { "timestamp": "2020-12-21T00:00:00.000000Z", "balance": 2723209316840 }, { "timestamp": "2020-12-20T00:00:00.000000Z", "balance": 2722897458808 }, { "timestamp": "2020-12-19T00:00:00.000000Z", "balance": 2722544226107 }, { "timestamp": "2020-12-18T00:00:00.000000Z", "balance": 2720485905293 }, { "timestamp": "2020-12-17T00:00:00.000000Z", "balance": 2719231394336 }, { "timestamp": "2020-12-16T00:00:00.000000Z", "balance": 2716992988275 }, { "timestamp": "2020-12-15T00:00:00.000000Z", "balance": 2714499571334 }, { "timestamp": "2020-12-14T00:00:00.000000Z", "balance": 2712996222990 }, { "timestamp": "2020-12-13T00:00:00.000000Z", "balance": 2703175106511 }, { "timestamp": "2020-12-12T00:00:00.000000Z", "balance": 2701913148104 }, { "timestamp": "2020-12-11T00:00:00.000000Z", "balance": 2699717238347 }, { "timestamp": "2020-12-10T00:00:00.000000Z", "balance": 2698120119399 }, { "timestamp": "2020-12-09T00:00:00.000000Z", "balance": 2696104012737 }, { "timestamp": "2020-12-08T00:00:00.000000Z", "balance": 2694835982946 }, { "timestamp": "2020-12-07T00:00:00.000000Z", "balance": 2692158753830 }, { "timestamp": "2020-12-06T00:00:00.000000Z", "balance": 2689398873651 }, { "timestamp": "2020-12-05T00:00:00.000000Z", "balance": 2687488073405 }, { "timestamp": "2020-12-04T00:00:00.000000Z", "balance": 2686193207861 }, { "timestamp": "2020-12-03T00:00:00.000000Z", "balance": 2684790604843 }, { "timestamp": "2020-12-02T00:00:00.000000Z", "balance": 2682678566170 }, { "timestamp": "2020-12-01T00:00:00.000000Z", "balance": 2680802668931 }, { "timestamp": "2020-11-30T00:00:00.000000Z", "balance": 2679059221953 }, { "timestamp": "2020-11-29T00:00:00.000000Z", "balance": 2677312562564 }, { "timestamp": "2020-11-28T00:00:00.000000Z", "balance": 2675534596168 }, { "timestamp": "2020-11-27T00:00:00.000000Z", "balance": 2674031525165 }, { "timestamp": "2020-11-26T00:00:00.000000Z", "balance": 2673184081131 }, { "timestamp": "2020-11-25T00:00:00.000000Z", "balance": 2671270944491 }, { "timestamp": "2020-11-24T00:00:00.000000Z", "balance": 2669603645697 } ], "last_day": [ { "timestamp": "2020-12-23T19:00:00.000000Z", "balance": 2726587598732 }, { "timestamp": "2020-12-23T18:00:00.000000Z", "balance": 2726587598732 }, { "timestamp": "2020-12-23T17:00:00.000000Z", "balance": 2726587598732 }, { "timestamp": "2020-12-23T16:00:00.000000Z", "balance": 2726579175524 }, { "timestamp": "2020-12-23T15:00:00.000000Z", "balance": 2726579175524 }, { "timestamp": "2020-12-23T14:00:00.000000Z", "balance": 2726322880219 }, { "timestamp": "2020-12-23T13:00:00.000000Z", "balance": 2726322880219 }, { "timestamp": "2020-12-23T12:00:00.000000Z", "balance": 2726306228185 }, { "timestamp": "2020-12-23T11:00:00.000000Z", "balance": 2726306228185 }, { "timestamp": "2020-12-23T10:00:00.000000Z", "balance": 2726306228185 }, { "timestamp": "2020-12-23T09:00:00.000000Z", "balance": 2726252381243 }, { "timestamp": "2020-12-23T08:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T07:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T06:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T05:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T04:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T03:00:00.000000Z", "balance": 2726236453934 }, { "timestamp": "2020-12-23T02:00:00.000000Z", "balance": 2726227814759 }, { "timestamp": "2020-12-23T01:00:00.000000Z", "balance": 2726227814759 }, { "timestamp": "2020-12-23T00:00:00.000000Z", "balance": 2726227814759 }, { "timestamp": "2020-12-22T23:00:00.000000Z", "balance": 2726184001677 }, { "timestamp": "2020-12-22T22:00:00.000000Z", "balance": 2726184001677 }, { "timestamp": "2020-12-22T21:00:00.000000Z", "balance": 2726184001677 }, { "timestamp": "2020-12-22T20:00:00.000000Z", "balance": 2725942362517 }, { "timestamp": "2020-12-22T19:00:00.000000Z", "balance": 2725942362517 } ] }}

List Hotspot Cities

List all known hotspot cities with the total hotspot count for each city.

Query Parameters

Response

javascript
{ "data": [ { "city_id": "aG91c3RvbnRleGFzdW5pdGVkIHN0YXRlcw", "hotspot_count": 52, "long_city": "Houston", "long_country": "United States", "long_state": "Texas", "short_city": "Houston", "short_country": "US", "short_state": "TX" }, { "city_id": "aG91c3RvbnRleGFzdW5pdGVkIHN0YXRlcw", "hotspot_count": 52, "long_city": "Houston", "long_country": "United States", "long_state": "Texas", "short_city": "Houston", "short_country": "US", "short_state": "TX" } ], "cursor": "eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ"}

List Hotspots for a City

Lists all known hotspots for a given city_id.

Query Parameters

Response

javascript
{ "data": [ { "address": "11C5PW3fe5RmBV7jvdmBJmjH7FjiZ3URAZ5oUj2V9dVsW83a5wU", "block": 403147, "block_added": 356922, "geocode": { "long_city": "Montrose", "long_country": "United States", "long_state": "New York", "long_street": "Dutch Street", "short_city": "Montrose", "short_country": "US", "short_state": "NY", "short_street": "Dutch St", "city_id": "bW9udHJvc2VuZXcgeW9ya3VuaXRlZCBzdGF0ZXM" }, "lat": 41.24450048207128, "lng": -73.93189556758152, "location": "8c2a10c020007ff", "name": "delightful-onyx-swan", "nonce": 1, "owner": "142dmsAe4qVmNxdZJuQiFmpSnB9p6wBkAX78MVza1yNrF4t5R6e", "score": 0.25, "score_update_height": 403138, "status": { "gps": "no_fix", "height": 403025, "online": "online" } }, { "address": "112PSCgC7kXWFnKWrczNL6srYKQpg3VdA9iou6FrQW4C1aot5HPc", "block": 403147, "block_added": 355849, "geocode": { "long_city": "Montrose", "long_country": "United States", "long_state": "New York", "long_street": "Sunset Road", "short_city": "Montrose", "short_country": "US", "short_state": "NY", "short_street": "Sunset Rd", "city_id": "bW9udHJvc2VuZXcgeW9ya3VuaXRlZCBzdGF0ZXM" }, "lat": 41.24464436633493, "lng": -73.94293581685558, "location": "8c2a10c024e1bff", "name": "wobbly-lipstick-manatee", "nonce": 1, "owner": "142dmsAe4qVmNxdZJuQiFmpSnB9p6wBkAX78MVza1yNrF4t5R6e", "score": 0.25, "score_update_height": 403097, "status": { "gps": "good_fix", "height": 402961, "online": "online" } }, { "address": "112Byc2EoL1yB7zyfC9ve2HayLoFf9WLvJdTDtevMsmkfxu9GAA1", "block": 403147, "block_added": 94932, "geocode": { "long_city": "Montrose", "long_country": "United States", "long_state": "New York", "long_street": "Sycamore Court", "short_city": "Montrose", "short_country": "US", "short_state": "NY", "short_street": "Sycamore Ct", "city_id": "bW9udHJvc2VuZXcgeW9ya3VuaXRlZCBzdGF0ZXM" }, "lat": 41.24524348318981, "lng": -73.93254191072695, "location": "8c2a10c020337ff", "name": "smooth-cobalt-cougar", "nonce": 1, "owner": "142dmsAe4qVmNxdZJuQiFmpSnB9p6wBkAX78MVza1yNrF4t5R6e", "score": 0.25, "score_update_height": 403117, "status": { "gps": "good_fix", "height": 403026, "online": "online" } } ],"cursor": "eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ"}

List Hotspots

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.

Query Parameters

Response

javascript
{ "data": [ { "lng": -122.39186733984285, "lat": 37.784056617819544, "status": { "online": "offline", "height": 394065 }, "score_update_height": 395577, "score": 0.25, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "nonce": 1, "name": "tall-plum-griffin", "location": "8c283082a1a19ff", "geocode": { "short_street": "Bryant St", "short_state": "CA", "short_country": "US", "short_city": "SF", "long_street": "Bryant Street", "long_state": "California", "long_country": "United States", "long_city": "San Francisco", "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz" }, "block_added": 395575, "block": 397023, "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db" }, { "lng": 5.5794356104890825, "lat": 45.13127467725158, "status": { "online": "online", "height": 391690 }, "score_update_height": 395502, "score": 0.25, "owner": "13wv9QctMFJqQpvbZq8GuwaKc7YxUuvMw6WQD5JouvB3L2kuGwT", "nonce": 1, "name": "keen-metal-halibut", "location": "8c1f933292185ff", "geocode": { "short_street": "Chemin de la Colline", "short_state": "Auvergne-RhΓ΄ne-Alpes", "short_country": "FR", "short_city": "Lans-en-Vercors", "long_street": "Chemin de la Colline", "long_state": "Auvergne-RhΓ΄ne-Alpes", "long_country": "France", "long_city": "Lans-en-Vercors", "city_id": "bGFucy1lbi12ZXJjb3JzYXV2ZXJnbmUtcmjDtG5lLWFscGVzZnJhbmNl" }, "block_added": 395500, "block": 397023, "address": "1122FqmqcH5uk8J1BSAStYK436GAR9CuwDVuBT2gRduofm9Vh7Lq" }, { "lng": -81.77662146961255, "lat": 24.55934059588725, "status": { "online": "online", "height": 396910 }, "score_update_height": 396984, "score": 0.2593841552734375, "owner": "131uuuyiYrPczy1aCKDBhvxYTG7ZMNfnZnKgemesd3CZEe3y6EU", "nonce": 2, "name": "nutty-daffodil-ferret", "location": "8c4416a324933ff", "geocode": { "short_street": "Seidenberg Ave", "short_state": "FL", "short_country": "US", "short_city": "Key West", "long_street": "Seidenberg Avenue", "long_state": "Florida", "long_country": "United States", "long_city": "Key West", "city_id": "a2V5IHdlc3RmbG9yaWRhdW5pdGVkIHN0YXRlcw" }, "block_added": 377240, "block": 397023, "address": "117ucorijFWJ662HH1q6aYz78Y5q2FfF9DMyx4Ka73vBqsEuuMG" } ], "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"}

Hotspot for Address

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.

Path Parameters

Response

javascript
{ "data": { "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db", "block": 397024, "block_added": 395575, "geocode": { "long_city": "San Francisco", "long_country": "United States", "long_state": "California", "long_street": "Bryant Street", "short_city": "SF", "short_country": "US", "short_state": "CA", "short_street": "Bryant St", "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz" }, "lat": 37.784056617819544, "lng": -122.39186733984285, "location": "8c283082a1a19ff", "name": "tall-plum-griffin", "nonce": 1, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "score": 0.25, "score_update_height": 395577, "status": { "height": 394065, "online": "offline" } }}

Hotspot for Name

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.

Path Parameters

Response

javascript
{ "data": { "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db", "block": 397024, "block_added": 395575, "geocode": { "long_city": "San Francisco", "long_country": "United States", "long_state": "California", "long_street": "Bryant Street", "short_city": "SF", "short_country": "US", "short_state": "CA", "short_street": "Bryant St", "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz" }, "lat": 37.784056617819544, "lng": -122.39186733984285, "location": "8c283082a1a19ff", "name": "tall-plum-griffin", "nonce": 1, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "score": 0.25, "score_update_height": 395577, "status": { "height": 394065, "online": "offline" } }}

Hotspot Location Distance Search

Fetch the hotspots which are within a given number of meters from the given lat and lon coordinates.

Query Parameters

Response

javascript
{ "data": [ { "lng": -122.39186733984285, "lat": 37.784056617819544, "status": { "online": "offline", "height": 394065 }, "score_update_height": 395577, "score": 0.25, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "nonce": 1, "name": "tall-plum-griffin", "location": "8c283082a1a19ff", "geocode": { "short_street": "Bryant St", "short_state": "CA", "short_country": "US", "short_city": "SF", "long_street": "Bryant Street", "long_state": "California", "long_country": "United States", "long_city": "San Francisco", "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz" }, "block_added": 395575, "block": 397023, "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db" }, { "lng": 5.5794356104890825, "lat": 45.13127467725158, "status": { "online": "online", "height": 391690 }, "score_update_height": 395502, "score": 0.25, "owner": "13wv9QctMFJqQpvbZq8GuwaKc7YxUuvMw6WQD5JouvB3L2kuGwT", "nonce": 1, "name": "keen-metal-halibut", "location": "8c1f933292185ff", "geocode": { "short_street": "Chemin de la Colline", "short_state": "Auvergne-RhΓ΄ne-Alpes", "short_country": "FR", "short_city": "Lans-en-Vercors", "long_street": "Chemin de la Colline", "long_state": "Auvergne-RhΓ΄ne-Alpes", "long_country": "France", "long_city": "Lans-en-Vercors", "city_id": "bGFucy1lbi12ZXJjb3JzYXV2ZXJnbmUtcmjDtG5lLWFscGVzZnJhbmNl" }, "block_added": 395500, "block": 397023, "address": "1122FqmqcH5uk8J1BSAStYK436GAR9CuwDVuBT2gRduofm9Vh7Lq" }, { "lng": -81.77662146961255, "lat": 24.55934059588725, "status": { "online": "online", "height": 396910 }, "score_update_height": 396984, "score": 0.2593841552734375, "owner": "131uuuyiYrPczy1aCKDBhvxYTG7ZMNfnZnKgemesd3CZEe3y6EU", "nonce": 2, "name": "nutty-daffodil-ferret", "location": "8c4416a324933ff", "geocode": { "short_street": "Seidenberg Ave", "short_state": "FL", "short_country": "US", "short_city": "Key West", "long_street": "Seidenberg Avenue", "long_state": "Florida", "long_country": "United States", "long_city": "Key West", "city_id": "a2V5IHdlc3RmbG9yaWRhdW5pdGVkIHN0YXRlcw" }, "block_added": 377240, "block": 397023, "address": "117ucorijFWJ662HH1q6aYz78Y5q2FfF9DMyx4Ka73vBqsEuuMG" } ], "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"}

Hotspot Location Box Search

Fetch the hotspots which are within a given geographic boundary indicated by it’s south-wesetern and north-eastern co-ordinates.

Query Parameters

Response

javascript
{ "data": [ { "lng": -122.39186733984285, "lat": 37.784056617819544, "status": { "online": "offline", "height": 394065 }, "score_update_height": 395577, "score": 0.25, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "nonce": 1, "name": "tall-plum-griffin", "location": "8c283082a1a19ff", "geocode": { "short_street": "Bryant St", "short_state": "CA", "short_country": "US", "short_city": "SF", "long_street": "Bryant Street", "long_state": "California", "long_country": "United States", "long_city": "San Francisco", "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz" }, "block_added": 395575, "block": 397023, "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db" }, { "lng": 5.5794356104890825, "lat": 45.13127467725158, "status": { "online": "online", "height": 391690 }, "score_update_height": 395502, "score": 0.25, "owner": "13wv9QctMFJqQpvbZq8GuwaKc7YxUuvMw6WQD5JouvB3L2kuGwT", "nonce": 1, "name": "keen-metal-halibut", "location": "8c1f933292185ff", "geocode": { "short_street": "Chemin de la Colline", "short_state": "Auvergne-RhΓ΄ne-Alpes", "short_country": "FR", "short_city": "Lans-en-Vercors", "long_street": "Chemin de la Colline", "long_state": "Auvergne-RhΓ΄ne-Alpes", "long_country": "France", "long_city": "Lans-en-Vercors", "city_id": "bGFucy1lbi12ZXJjb3JzYXV2ZXJnbmUtcmjDtG5lLWFscGVzZnJhbmNl" }, "block_added": 395500, "block": 397023, "address": "1122FqmqcH5uk8J1BSAStYK436GAR9CuwDVuBT2gRduofm9Vh7Lq" }, { "lng": -81.77662146961255, "lat": 24.55934059588725, "status": { "online": "online", "height": 396910 }, "score_update_height": 396984, "score": 0.2593841552734375, "owner": "131uuuyiYrPczy1aCKDBhvxYTG7ZMNfnZnKgemesd3CZEe3y6EU", "nonce": 2, "name": "nutty-daffodil-ferret", "location": "8c4416a324933ff", "geocode": { "short_street": "Seidenberg Ave", "short_state": "FL", "short_country": "US", "short_city": "Key West", "long_street": "Seidenberg Avenue", "long_state": "Florida", "long_country": "United States", "long_city": "Key West", "city_id": "a2V5IHdlc3RmbG9yaWRhdW5pdGVkIHN0YXRlcw" }, "block_added": 377240, "block": 397023, "address": "117ucorijFWJ662HH1q6aYz78Y5q2FfF9DMyx4Ka73vBqsEuuMG" } ], "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"}

Hotspots for H3 Index

Fetch the hotspots which are in the given h3 index. The supported h3 indices are currently limited to resolution 8.

Path Parameters

Response

javascript
{ "data": [ { "lng": -77.90290276709354, "lat": 40.80885497979477, "timestamp_added": "2020-10-30T00:03:08.000000Z", "status": { "online": "offline", "listen_addrs": null, "height": 829767 }, "reward_scale": 1, "owner": "14Cx6WkXKpaD3GFf9VkG8kLsYjQ325y4egFZKs2vJ2hB5Ftrg66", "nonce": 3, "name": "zesty-cinnamon-lobster", "location": "8c2aa38c2a06dff", "last_poc_challenge": 829703, "last_change_block": 829807, "geocode": { "short_street": "N Atherton St", "short_state": "PA", "short_country": "US", "short_city": "State College", "long_street": "North Atherton Street", "long_state": "Pennsylvania", "long_country": "United States", "long_city": "State College", "city_id": "c3RhdGUgY29sbGVnZXBlbm5zeWx2YW5pYXVuaXRlZCBzdGF0ZXM" }, "gain": 12, "elevation": 0, "block_added": 565473, "block": 842630, "address": "1114BGcrdwhio7beaKEP49vp8sjrYAzsubonZV7nPrwoZxr4Ns4" } ]}

Hotspot Activity

Lists all blockchain transactions that the given hotspot was involved in.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "fee": 70000, "gateway": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db", "hash": "DXciS1wFRf4CAfK_FPl-nE3l_YhisFibOmY2vXE0e3s", "height": 395577, "lat": 37.784056617819544, "lng": -122.39186733984285, "location": "8c283082a1a19ff", "nonce": 1, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "payer": "14fzfjFcHpDR1rTH8BNPvSi5dKBbgxaDnmsVPbCjuq9ENjpZbxh", "staking_fee": 1000000, "time": 1593622131, "type": "assert_location_v1" }, { "fee": 65000, "gateway": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db", "hash": "VSO7aKH9uiCuWUNzb5rPddlq-m-kvaMeVeufUQisjbo", "height": 395575, "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT", "payer": "14fzfjFcHpDR1rTH8BNPvSi5dKBbgxaDnmsVPbCjuq9ENjpZbxh", "staking_fee": 4000000, "time": 1593622029, "type": "add_gateway_v1" } ], "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"}

Hotspots Activity Counts

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.

Path Parameters

Transaction Types

Append the version on the transaction type name, eg: payment_v1
  • add gateway - Add a new gateway to the Helium Network. For the purposes of transactions, a β€œgateway” is the term for a Helium-compliant Miner that is mining and providing coverage.
  • assert location - Assert a gateway’s location on the Helium Network. This happens after a gateway has been added via the add gateway transaction. Once asserted, this location is then used as part of Proof of Coverage challenges. A Miner’s location can be asserted more than once but each subsequent assertion will a) cost a fee and b) reset that Miner’s score to neutral (.15)
  • chain vars - Change a chain variable.
  • coinbase - Similar to the bitcoin blockchain’s coinbase transaction but used only during testnet phases of the Helium blockchain. The rewards transaction has taken its place.
  • coinbase data credits - Created the initial 10,000 Data Credits required to bring the first group of Miners online.
  • consensus group - Marks the election of a new consensus group, responsible for mining during the next epoch.
  • create hashed timelock - Creates a transaction that can only be redeemed by providing the correct pre-image to the hashlock within the specified timelock.
  • create proof of coverage request - Submitted by a Miner wishing to initiate a challenge.
  • data credits - Burn HNT for DCs at the current oracle price and deliver them to the target wallet address.
  • genesis gateway - Used to define the initial group of Miners that bootstrapped the blockchain.
  • multi-payment - Used to send $HNT from one wallet to multiple wallets.
  • OUI - Create a OUI for a new router on the Helium network. In the Helium blockchain, Miners forward packets to Routers that own them based on their OUI as stored in the blockchain.
  • payment - Used to send $HNT from one wallet to another.
  • proof of coverage receipts - The result of a POC submitted to the network upon completion.
  • redeem hashed timelock - Redeem the transaction created using the create hashed timelock transaction.
  • reward - A token payout for a specific event on the network such as submitting a valid proof of coverage request, participating in a consensus group, etc.
  • rewards - Bundles multiple reward transactions at the end of each epoch and distributes all $HNT produced in that block to wallets that have earned them.
  • routing - Update the routing information associated with an OUI.
  • security coinbase - Distribution of security tokens in the genesis block.
  • security exchange - The transfer of security tokens from one address to another.
  • state channel open - Opens a new state channel on a Helium Router
  • state channel close - Closes a specific state channel on a Helium Router
  • token burn exchange rate - Change the exchange rate for burning $HNT to DCs.

Query Parameters

Response

javascript
{ "data": { "vars_v1": 0, "transfer_hotspot_v1": 3, "token_burn_v1": 0, "token_burn_exchange_rate_v1": 0, "state_channel_open_v1": 0, "state_channel_close_v1": 0, "security_exchange_v1": 0, "security_coinbase_v1": 0, "routing_v1": 0, "rewards_v2": 1082, "rewards_v1": 9180, "redeem_htlc_v1": 0, "price_oracle_v1": 0, "poc_request_v1": 0, "poc_receipts_v1": 0, "payment_v2": 16, "payment_v1": 11, "oui_v1": 0, "gen_gateway_v1": 0, "dc_coinbase_v1": 0, "create_htlc_v1": 0, "consensus_group_v1": 0, "coinbase_v1": 0, "assert_location_v2": 2, "assert_location_v1": 4, "add_gateway_v1": 5 }}

Hotspot Elections

Lists all blockchain transactions that the given hotspot was involved in.​https://docs.helium.com/blockchain/consensus-protocol/​

Path Parameters

Query Parameters

Response

javascript
{ "data": [{ "delay": 0, "hash": "bGZCTdsBxM5m0IuVLcy0RvJf_OOkZ3C9C-TsvmuoQ50", "height": 372552, "members": [ "112mRr9U2QkP5svLtTZjnGZ9qMwExoY8zz3Y5KyNYh6eKsvhsaxT", "11edHhAK28WHFMZ6D6HTKnzer9jXNRq57ghzxv1ij7ERPMXRKnH", "119hQxQAhkGT7dWMPXoPH4E811PzJB9PsgVjsTcUCDLPaCT9aNP", "11gQQknec6vuRm8exJU4UG9pyT1e1NXr6yZV7sjPdCwvXaYCJBN", "112VVqgL1LRxy6jhAM4AtNVa4qDcw1KmfGf4HjkjQAszo23EqYYY", "112L7A2Xpkh7fjKjuaTfq3WgEn9nnAXg2M7BTWsR9dYvn4eopguz", "11Qg88VmPkmv2oZggft8THbNhMKtnhUjBVPFJdy33q64GFu5JPN", "11tWRj2Qhnn177iVYm3KUmbPdMyhRfeqHqk9kCyiR7y57hdG9JA", "11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE", "112HwmAx3XVW2NUGWa9Gk1yB2zkxXE6Bv4FXgop5Was5Msa7SUcH", "1129waT8yUcphrcgYecpoXQtSGh9HS7NZfc6EfBHhQgYKJGibBHH", "11wevymXjkG1zPE717qjb8hJQpUaJZMMp4kr3AegmTQpu1jhZ7e", "112uxvcQWcdBCgYkCPZGZaX3Fmpe4Xrx21qBNFyfA7YyEqEY6rbm", "1144JMF9rZsvUfW7x6koYbKbYpp86gL1xUzWohejeSZti5aPXo4", "112NpqyB7Jq3SrmG8tbMwW6rwic8ftpkDFPsechdRzuLE59QSNmY", "11sVuJATssrZChv2uLe3pXbLfzBkfeeLSYhfZn8kgiwAq4oJJ7D" ], "proof": "g1AAAAdBeJxN1Hc422sbB_D4EZqaPVachCb2KPISLaexSuz3xGlfSq2gRtrUqFipWrFqROkxYnVQRUvNcy4cRZrkoLRV0qjWKClqtJza8-gf0fev55_7uj7393nu-yGCQCCJQODa4YEEMQJEOM-LWgy11VO2wWOG3h6XuP9s6LI83lXRLtnaLUZ8r7JGYQGEZ9xppKfYt0mNqfvtaqfsLKROmLSmzQq4PHSrUdR7cvwTgAS1VY8HZUqkYHGsZFP3B5XwoaXWQuIN--dDCbP-roluSJ5JWlU_c92rEPZ1YWQLvlDqtiS-QE2tQGCvmpr6l05w5ngmEpShHz1Ains1dSXBcFsqb94qLgn_7MXcItGxdE3cySs6FUBIYIL_JhGUGkIzVPK3-cj-JvbZw21TwST51LRk59BAC57pFMzvwVjcHGUKpR8Lh939dP7s1jtRk-ZUJfQgmRE4ufjDTMnYHKmOW_6JLv-5PLyJUzUUJhyBFqGDpyMDLt3rO-kMICJ0gnFS572P__Si1lSw-aXZ41UWSxp9Dc9OusCebN_t55mCyzOfVOrSg3QyDKl0556cK4IvWDOim9CW6mWHRWX2_-VMzWX9NQNB7qfNFC5y7flj875uK0ef5vt9PSIpHVCvqQcQQcutr9NY4oN7OHdJVk-ZW7-d-2gtLK_qWz2lQ7rRS4lnFhwErFusg53BbBUZ6emL_IaWJ90Ezul2nfogJ-Dopur3w2yCygcrfMas01kC97iMEOh4lOQuC2TLiv19UHGjVOo1gDDK-ScxUmbf7TJRR_bGz4m6fcEnA96C3p57XKoePuFEWOOZNVqxJv13NbbWtrDYoYE-pVqS_PCXjwoZmM27Doy3KPbRDMHem-CyXNL41WyekovwK5A-5RxBboZ7Xl2s6RghXK7psKvqhY9tqfw2Kd4ZRtsJ1045202_2s8ItJKObMZe1JZpTOaZLWa3Q2bIDXk7JGzbSGUXSSFPZlCWQGT88uJNOZzqa_29ygplCSCcn6uAByhBhAnjGMsHzE6JpHk-y5iPYWGrtx1BmXYmVADhnmjXGrIsFUv5gptbM5n8TewWVcRj51hwgaNvpXZF1jaPlOw0z1VdY73kgyMV9-2G5Qlwzd7Y7fuvllZ6E99E6escxYSgfFvS-7sV-D4n6IyQoflaulOQ6x82Oyq_eUXxj1u0HcYsLVaf0GTG4kgraC2BcxOcn5GMVntR-irQq3OPs5_J4ZkG3Un6253dK9PxzyFFxNYKzFInrVPIPoJ2ofbm-xqztaOY2j00abHZt3S5nCoruKvm17mQ_baZALojOArnzZJeNAEQwMv7w8y1HRG00A38uKlwch0kW7bgpECo_jwZLdweZcwjd9b0S-gLal-euD96uE3d7Aw_VXEuslRhkvkLak2Mq8A-IoX0Cn4VvZJXYZIzPnHfrfFWs-xlrkeB7tAfkQTqh8T8JgBhsCvfvdfxDO5S9hjeCUGKzTAfjkCdvSl8Orpaq7SteB4ZI2e0pYyCSUYbB3RMu4oP8T1yOas49ufZenH3Vd2_fNaPSKji7QP9TRC0B1yPVVGx2IWKQG8nvWFgQ7lPKFroLB8AQfw6gTb0naa4C16-LlsoyBa6yqpICKJSXT09utoKq0t45FMp_RMG_BifTUllSXGJvF6vnNQaTm6rverGaPFTvQjCEWk2LziAoe9lV-Hj5YWHnTTqnbv-964OXuk0Jdp6xnMVByDEFJyK8pPRmKxpavaG7XmPHdg1ncb-CkVffzkrmeL6ah7pGpXgA4-5Ryixb44TSOi_cBV1p4_c2kBUIvow7cRr__tjNQvxLkuBcTAQ92-yHO2hIh2nnWtYQhFIC8ZaZNQRb_UCCMUVCb_Rdu-D-phML0_zIZ9Q46TAD_w3-7sb6xDHu8-a88y5OxRIobWSYVs-17Ya8myn5UFBUPlGfNTBXkJmZgFM5WhmJURoRGlWgbCq7qU4s0ddlWo2s38aiAXfeCM6muL_GyH-sKsy293iskprGaMym7TojiwHkoPXzfcD5kFex8w6HP0sjl6TEqJR6uWugYn6o1YJQHkiGk4ozP_qQOfQVcGd_tPJuUdXC2u0OugSOwMtVo9n5sM0m9QGxozxz6xJp2NzZzW8e1MAxEWasGXJf2yiN0lG4hupTXGD5qGvmWF-eCe_CvwGQ43MI69XlzXIYJpO2L_qQR6UTkqHVUk2QhN9TZflAE3oxTqb71U2KKvDEPWcogNtGnwlWwas9bLftVyv_IwjZ6xC76orW9JgjzDz_QuiGBiYtb9nN_hb2RTnjWGEyHfqyHsxj0Gx6Y-UC2yWrvwLgaEVxg", "time": 1592112154, "type": "consensus_group_v1" }, { "delay": 0, "hash": "22qhsNH-Rw-5v8exId1KHgitBAwPf45SPMwhpyylyKI", "height": 372448, "members": [ "112mRr9U2QkP5svLtTZjnGZ9qMwExoY8zz3Y5KyNYh6eKsvhsaxT", "11edHhAK28WHFMZ6D6HTKnzer9jXNRq57ghzxv1ij7ERPMXRKnH", "119hQxQAhkGT7dWMPXoPH4E811PzJB9PsgVjsTcUCDLPaCT9aNP", "11gQQknec6vuRm8exJU4UG9pyT1e1NXr6yZV7sjPdCwvXaYCJBN", "112VVqgL1LRxy6jhAM4AtNVa4qDcw1KmfGf4HjkjQAszo23EqYYY", "112L7A2Xpkh7fjKjuaTfq3WgEn9nnAXg2M7BTWsR9dYvn4eopguz", "11GSd5uyaRF3BkYWc7XGVDz8FzMRTxBi5bHy5ZWjg8jN9mv5gnY", "112qdBK6mYPCnovBTcUSPSspo5dDF2GQL7TXHNKihoiqYnDwaizS", "112wEDaaeDbUUCNtcjd8LCX6epXuRvSM9qQZW2KtyM2vDgT6GK5N", "11eMofv6oYA3Y7LE4EZxJzwxzyjNHdedKSMNDP5y8pCuvnaMRQ6", "11Qg88VmPkmv2oZggft8THbNhMKtnhUjBVPFJdy33q64GFu5JPN", "112M6AiQEedVsuzfw5au1WFUgSPEiaVCU31Aa1xjCHFYX8WohEnC", "11tWRj2Qhnn177iVYm3KUmbPdMyhRfeqHqk9kCyiR7y57hdG9JA", "11ADL7tz5fazKdFM21kdo6K11k7bpjun6JwY22N4tx6ab6mjrYx", "112Pah4kwPwuVmCTmD1T5tiM2YZTQ4MmoFg68zxwyZsiYVtk8Bx3", "11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE" ], "proof": "g1AAAAdAeJxF1Hs4E2ocB_A1cj3llsSMjdMey23ouIUcJJeTldyblrnMMkTMIveVhNJIxhA5RW5JLqu0LGLuoyJ3Z045c4nYXHI5-mPrr_ef7_N83u_z-70vHgAASAcCg_cOKKBhbVesCiV7ozLaU7-GSqlckAw98eRLmw7P6pmRLMki5WfKFmEDhEi3W7VxTtmh26aaSp_vJmCvyvou1lGLoJ4kvP0kBcEBQhTTqibpzEfItQzUloh4-WCjZIaIMdXVheEw4d5SDtfnk66hQt6t8-sjbaK3xSJBRf86n9j4fMDiRYr6cVZ0a-DUvIC0_Xsbe_6LP7Sl-zDuxWhm5FyteTBWaesuF26-sjqgfAMIiTHIflIEi_sY6aikIBtve2jjWX8tNBzTxeshmizuFkzzyeQr8AI0Cm5GbKhSByIuQmplVDhOfzGGGLD99AD2DfLP1GnEKSAkDLv1EFkrnZFyDL9SzSNl9idq330xj2vSUPt-_aFapiwQCvgU693N4qhYKWpdlQje56_CmuYNbOmWWV8zXG4thGct8c1W7G9D7_LqjbU1bm7uHzf28faa-b6m-977cxnFy95hniCoCd2KyrTZtdN4Y8nxvvBYhETUCbzalHRn2HU4Ht4HVJwGQiLlC7WGXMwPgoe9sNXJck6FF1flDDVqqCtn_OjFz24z-KQc_U8yjPu-d58yVG3H4QMYp3yMGbdZ3LewzEwaIBroCGqK-a6KhnUpm7SU-oqL9H-yhBUbeaahYm7KO7OiKQGM13s1S8I9Zz8WdEqEsUHiuh5CIjpW3O76UhQoLL7cY_AWy4pvRqxqGIWjc0Hf5oY3lOcKLixIzd1JKYWcCjp5MqBgcmhWUNMNLF2-9NzzGm8HpMjL1Q9ugm_fDxiwKEEO5JAzo8TAeyt2eFQFbLR4YokWeysDnvq5vgDR_IByQDqda1rx2MLclk_uDL7Bd5D1elj9nP-CQuWVJP_yEqkgM0dktnk9RzFu-YKaqNcbvEf_eDh2TXrMezE-3B7XYtVx9sUctPbVlEAxBrh7NQdcsjeLc1obrRH2CqXFgY1-7GUTzWqckHsE1wv_UQ_EN78r6WwbacVEZOcnVOPiaL6jqZllWl2Xns5PltdU-OV3800o4F42qfzyLl3B52y9Yiekujb4SNjuNYIxIKlCt_FKt4QHEKJ1jir91uFsSi-CDIaPY4bI7uOmU2M2uLSgQ3Dac8JBvvlHC8lgk96yzE54J56Hp5WaLdApdFFHAuV8VezoU0vuL7Nk5Fni5MhZnNldztKsSIwNF0wLjMGsZJsL3zluYJu3AoSYN6I7arXkbEiMVaf_3qs27DM97dmCjxx7zSohFXMc0_jmoTl58cBQvcn-bc02340ygKlKfw4FG-6V9e7DDD0Peu5nyg5hu2dS8DqqmoSUmIpB_2ZftLWmGW29vZGF1g0rkohP6P82sRdJvX5TW8LFCqpsGOJsdh_h-z4XiuzbUfJtOphsErtulcNHa5FZrrbXsBHJas2Kb7No26BvrhLQsKeUQs3iXOirI4mCHbJc_I4KI2IkTW41tqvFn1nsZ6cSSJNypRG4BR26COgAEOLqdrZX2PuKKNsk1zrtTY6LxdEgRpTqE327e_sn2iv1WvnkbFayeO5pdeOXOTP25eJvftSXPAh5tJZA3N1OTE9_ADoqIAlsE2KpRtM6EPYV1tMLU4jHIi_99pmXBOiwJbj3EB2AEMiP80hVq2EYd_HrfHd25xFCl0u55fir5UFn6vHLNZHtfFJdaoNnNWthoRDd4GQzL3b4WNyy1NJKoZ9BobSQ24y_269xzpxcSyseGzXskCjSjst3dkjtdjmQQ3mY8rIuWjsDA-sAQkzfcZXBRL3OFia7IMi6QC5T4y25zjOdrXb630eLBsOyfNOTmIhRvv4QR3V8ES-c2H0-CJHVGU2rxavjMW0OUlVnfpllQSj9E_-0_N4j5AScCFkAIBVf5ll6f_FTYg9-sSfrRgEhPkE1qslel9CAubpYfZnmrz6G-q7ioqiyl1560x-YEa_5psvgEFSyKTx0RvjbrdbNjYtaFwqUPSq7o7Zn4juglWPBgucZ8iOtszXWIg0qM3KSPjEpnd3Tc6N3u5L-agKUFLRpILF3KyqB1Nkp6dNXwrx-LumUys10eWZfNsIdDV6ANjXLPheMs-aQgcwfQmaYdbnf5aSk7zPR91KeDpFpjrC1kfwafQJOME7AykB0igxjyv-IEtLa44FR37SGZIOhHSxN2KkYkSFM2PuFpvx8wj9iWGX2xncTXjHHAkIuatpj43eq-qg5XBck7fL_jZ4mIA", "time": 1592105642, "type": "consensus_group_v1" } ],"cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"}

Currently Elected Hotspots

Returns the list of hotspots that are currently elected to the consensus group.

Response

javascript
{ "data": [ { "lng": -74.01032445204942, "lat": 40.72147348660547, "status": { "online": "online", "height": 488871 }, "score_update_height": 488768, "score": 0.9685516357421875, "owner": "13cAirRyuUzK9pWNHQoQnk6ikLYCxHyACQvV6RJMdt4ymyNpD1K", "nonce": 1, "name": "cool-tawny-chameleon", "location": "8c2a1072c44bdff", "geocode": { "short_street": "Washington St", "short_state": "NY", "short_country": "US", "short_city": "New York", "long_street": "Washington Street", "long_state": "New York", "long_country": "United States", "long_city": "New York", "city_id": "bmV3IHlvcmtuZXcgeW9ya3VuaXRlZCBzdGF0ZXM" }, "block_added": 157683, "block": 488901, "address": "1124V1P146uMRpNvyuoRc8Uda1G54wqVBPuRzxzNuhEMFdNFkuaD" }, { "lng": -94.24977711202023, "lat": 36.334097707199234, "status": { "online": "online", "height": 488885 }, "score_update_height": 488783, "score": 0.9935455322265625, "owner": "13ickN56yPe38a3Vga161gp4nkSLckWvy7JChvnFr9osfP4AHGE", "nonce": 1, "name": "colossal-tangerine-reindeer", "location": "8c26ed42c3915ff", "geocode": { "short_street": "SW Layton Rd", "short_state": "AR", "short_country": "US", "short_city": "Bentonville", "long_street": "Southwest Layton Road", "long_state": "Arkansas", "long_country": "United States", "long_city": "Bentonville", "city_id": "YmVudG9udmlsbGVhcmthbnNhc3VuaXRlZCBzdGF0ZXM" }, "block_added": 100810, "block": 488901, "address": "11Fi6ynL2ecRiTGoJGtLcWYPJXQv1aH4jxgbUTejZtu4rBtvUYZ" } ]}

Hotspot Challenges

Lists the challenge (receipts) that the given hotspot a challenger, challengee or a witness in. This route is paged using a cursor.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "type": "poc_receipts_v1", "time": 1593711283, "secret": "AGzlnZfDnyFn1F_aLLlgYErFiEIAtFH0qTVV68pAibwNBOaVB2Wvnn2ZeF_unWN55Ld_7VXemk64lPHnjsOG_1YLXDnP7RT4EGELD9xriv1AZbNCoMAfY-xPhRHlf3YVPms", "path": [ { "witnesses": [ { "timestamp": 1593710795471113454, "signal": -78, "packet_hash": "5AN5Y3hcAVqZk_9KFetSbh-Z_qPGSeN-MFcH7neSyNM", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60c37aa5ff", "gateway": "112QWbkXGkZ5dSkP2511A6aYGLyabeLRRnd7un22WhQNShfSbXNc" }, { "timestamp": 1593710795459449071, "signal": -71, "packet_hash": "5AN5Y3hcAVqZk_9KFetSbh-Z_qPGSeN-MFcH7neSyNM", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60c4b46dff", "gateway": "11iYaU281c2Yjo2tvMxyeu1t95Cv7aLWuAoBYte51gZ7bKijzpj" } ], "receipt": { "timestamp": 1593710793585261540, "signal": 0, "origin": "p2p", "gateway": "11a44i7ry5WQ2ZuPTL5Hpx7RkQBHevNwiQkpU6sZgGxkYQ9K59o", "data": "o9w" }, "geocode": { "short_street": "Washington Ave", "short_state": "MI", "short_country": "US", "short_city": "Port Huron", "long_street": "Washington Avenue", "long_state": "Michigan", "long_country": "United States", "long_city": "Port Huron" }, "challengee_owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "challengee_lon": -82.43305482993941, "challengee_location": "8c2ab60e3c14bff", "challengee_lat": 42.98855335905615, "challengee": "11a44i7ry5WQ2ZuPTL5Hpx7RkQBHevNwiQkpU6sZgGxkYQ9K59o" }, { "witnesses": [ { "timestamp": 1593710797368850439, "signal": -95, "packet_hash": "viJWqE5v96u8eKCRwTqm-bf2IlD2m87N3A0SKs7Yf4c", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60c37aa5ff", "gateway": "112QWbkXGkZ5dSkP2511A6aYGLyabeLRRnd7un22WhQNShfSbXNc" }, { "timestamp": 1593710797331238274, "signal": -102, "packet_hash": "viJWqE5v96u8eKCRwTqm-bf2IlD2m87N3A0SKs7Yf4c", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60c170b9ff", "gateway": "112LxPghCf7qXigCBRz74LTAKKvPtfYPjqPxbBpkie9E9BcrMDdc" }, { "timestamp": 1593710797335494047, "signal": -93, "packet_hash": "viJWqE5v96u8eKCRwTqm-bf2IlD2m87N3A0SKs7Yf4c", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60c4b46dff", "gateway": "11iYaU281c2Yjo2tvMxyeu1t95Cv7aLWuAoBYte51gZ7bKijzpj" } ], "receipt": null, "challengee_owner": "14cSUPEX76FLdhjgyT6Y6fBFYzeJdTjTMDDrHDnpeA8tSXmYrfq", "challengee_lon": -82.4633534637547, "challengee_location": "8c2ab60c024adff", "challengee_lat": 42.94538752297601, "challengee": "1123VfBqFkbBfLtMZiYMR2WoUew2tZWWdZcoVHGRG2KSq7pYtCpJ" }, { "witnesses": [], "receipt": null, "challengee_owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "challengee_lon": -82.46035597096102, "challengee_location": "8c2ab60c14219ff", "challengee_lat": 42.941715433247545, "challengee": "11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ" }, { "witnesses": [], "receipt": null, "challengee_owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "challengee_lon": -82.49094619308394, "challengee_location": "8c2ab60c37aa5ff", "challengee_lat": 42.93231949041608, "challengee": "112QWbkXGkZ5dSkP2511A6aYGLyabeLRRnd7un22WhQNShfSbXNc" } ], "onion_key_hash": "YM1oa4GmFBucT2g5NXHSN4CH907uuEo7waMnDIVG85k", "height": 397058, "hash": "tmWvGykf9sIjix1VxkYQwRjz1jzwuluGvVxDnMwWAZ4", "fee": 0, "challenger_owner": "14ZxnCvJq9wNgdFjLGatcYCjxdnT3RfzJ6dkVHNB9Wkwq5FHLj4", "challenger_lon": -118.49635947992698, "challenger_location": "8c29a19ab59c1ff", "challenger_lat": 34.02420568554961, "challenger": "118AgJni9yvsbX1nJF8ZRhXXtdPqEsSoshaZV9G9fyYz1Miwk2b" }, { "type": "poc_receipts_v1", "time": 1593709051, "secret": "AA-QE2YLG0iIIc1KO4FA7zJSiGDYVTgxoi7bKtn7TcfABNru4ZZmh5Wo_j88yUGDXW7m_jmYc1nq8Rn8b3rmxkCBUVw31SW88BtNyWYdI4RqwHXWmtA-fqrq-Ksr0KvgA_I", "path": [ { "witnesses": [ { "timestamp": 1593708823109097719, "signal": -103, "packet_hash": "bAxUoDw2Ypgv1qY6ZzFZBYun99Fa_ch4VPqKhdBZJD8", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60e38113ff", "gateway": "112bM2Comn8VD9KXMYdKZYeSUKwRuJDWUJc2YbfKbDgHwArnt46a" }, { "timestamp": 1593708823104408242, "signal": -99, "packet_hash": "bAxUoDw2Ypgv1qY6ZzFZBYun99Fa_ch4VPqKhdBZJD8", "owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "location": "8c2ab60e318e7ff", "gateway": "119td1MLCtGEAjnGJjMXTh6dcyq3FwW2gxoU9Ev5jrmE1f6aZQh" } ], "receipt": { "timestamp": 1593708821274903421, "signal": 0, "origin": "p2p", "gateway": "112mBp6av2P1Ko7aXQZSSBiZLPxi9dP2YL1E1M8ysBx9MbKPR4FJ", "data": "zw0" }, "geocode": { "short_street": "Military St", "short_state": "MI", "short_country": "US", "short_city": "Port Huron", "long_street": "Military Street", "long_state": "Michigan", "long_country": "United States", "long_city": "Port Huron" }, "challengee_owner": "14cSUPEX76FLdhjgyT6Y6fBFYzeJdTjTMDDrHDnpeA8tSXmYrfq", "challengee_lon": -82.42495037863101, "challengee_location": "8c2ab60c5b05bff", "challengee_lat": 42.961154068414594, "challengee": "112mBp6av2P1Ko7aXQZSSBiZLPxi9dP2YL1E1M8ysBx9MbKPR4FJ" }, { "witnesses": [], "receipt": null, "challengee_owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "challengee_lon": -82.46035597096102, "challengee_location": "8c2ab60c14219ff", "challengee_lat": 42.941715433247545, "challengee": "11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ" }, { "witnesses": [], "receipt": null, "challengee_owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp", "challengee_lon": -82.45085880023731, "challengee_location": "8c2ab60c426e7ff", "challengee_lat": 42.9667313386322, "challengee": "1128s66jgeG9oxw33FV7Gw52wfNukPSKGupB2C7N3w1poid5LeRC" } ], "onion_key_hash": "py6G-BruPSyZQaTAoakOtOlHH5R7CVA_Ttn3ALt6j90", "height": 397017, "hash": "azI_l34BanrX73rYT7E7rKbqzEK_NqoKWckPRQUrvMo", "fee": 0, "challenger_owner": "13NjZfyLXDWks8mhgrwN7Mw9tN2Fm1qJ7XG6LVTqvdUHgCRYz2f", "challenger_lon": -73.98415801053285, "challenger_location": "8c2a100d225ebff", "challenger_lat": 40.731030047462795, "challenger": "11iaWmYt7ixwXqbWkCaYf5b9tS24GNy7Fq3af1MSNkfGGvKVPX5" } ], "cursor": "eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwfQ"}

Rewards for a Hotspot

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.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "account": "12xUoMKwf12ABjNx4VCvYcNkX79gW1kzz2JnBLxkFbjswRczRvM", "amount": 7885016, "block": 470788, "gateway": "113kQU96zqePySTahB7PEde9ZpoWK76DYK1f57wyhjhXCBoAu88", "hash": "DTU1GGfR0eU15hv6KiV_bg6FOJXfUWz4TjIq1H7TGy4", "timestamp": "2020-08-28T01:29:46.000000Z" }, { "account": "12xUoMKwf12ABjNx4VCvYcNkX79gW1kzz2JnBLxkFbjswRczRvM", "amount": 3612069, "block": 470753, "gateway": "113kQU96zqePySTahB7PEde9ZpoWK76DYK1f57wyhjhXCBoAu88", "hash": "l3EQR6AJ6R1qE1meHyafDnNF8vJ-X-rH1pujxQRTds4", "timestamp": "2020-08-28T00:50:44.000000Z" }, { "account": "12xUoMKwf12ABjNx4VCvYcNkX79gW1kzz2JnBLxkFbjswRczRvM", "amount": 8623955, "block": 470509, "gateway": "113kQU96zqePySTahB7PEde9ZpoWK76DYK1f57wyhjhXCBoAu88", "hash": "5fQJY9MprH9b3IstVU1SdfBteUWoF_sdsVuiARPBtTY", "timestamp": "2020-08-27T19:01:48.000000Z" }, { "account": "12xUoMKwf12ABjNx4VCvYcNkX79gW1kzz2JnBLxkFbjswRczRvM", "amount": 4009855, "block": 470475, "gateway": "113kQU96zqePySTahB7PEde9ZpoWK76DYK1f57wyhjhXCBoAu88", "hash": "0M0fudEmzW9dmAsO3dcWT286tTL6wTX9sllXtsyz-0Q", "timestamp": "2020-08-27T18:15:17.000000Z" } ]}

Reward Total for a Hotspot

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.

Path Parameters

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).

Query Parameters

Response

javascript
{ "data": { "max_time": "2020-08-29T00:00:00Z", "min_time": "2020-08-27T00:00:00Z", "sum": "164942208" }}

Witnesses for a Hotspot

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.

Path Parameters

Response

javascript
{ "data": [ { "address": "1117PRWasdEhTUEeGykmjx5bcQbsRQ7mCuYRHERtrgb4hqBio4u", "block": 290247, "block_added": 192280, "geocode": { "city_id": "YXRsYW50YWdlb3JnaWF1bml0ZWQgc3RhdGVz", "long_city": "Atlanta", "long_country": "United States", "long_state": "Georgia", "long_street": "West Peachtree Street Northwest", "short_city": "Atlanta", "short_country": "US", "short_state": "GA", "short_street": "W Peachtree St NW" }, "lat": 33.779308359988256, "lng": -84.38786168354673, "location": "8c44c1a8e2737ff", "name": "small-neon-finch", "nonce": 1, "owner": "14C18AnFwMVXovgR4mskV5AyDH8n9vAx2PPNEjM5NVjFuK9GaTN", "score": 0.25, "score_update_height": 290229, "status": { "height": 468420, "online": "online" }, "witness_for": "112hYxknRPeCP9PLtkAy3f86fWpXaRzRffjPj5HcrS7qePttY3Ek", "witness_info": { "first_time": 1581085089619105739, "histogram": { "-100": 0, "-108": 0, "-116": 3, "-124": 0, "-132": 0, "-60": 0, "-68": 0, "-76": 0, "-84": 0, "-92": 0, "28": 0 }, "recent_time": 1581506570759026847 } }, { "address": "11TdnjY3VAL71LLd1KMMhY4SzMUAiYo1uP9bgBJSZJhDZ8rUfNh", "block": 290247, "block_added": 226358, "geocode": { "city_id": "YXRsYW50YWdlb3JnaWF1bml0ZWQgc3RhdGVz", "long_city": "Atlanta", "long_country": "United States", "long_state": "Georgia", "long_street": "14th Street Northeast", "short_city": "Atlanta", "short_country": "US", "short_state": "GA", "short_street": "14th St NE" }, "lat": 33.78595728279224, "lng": -84.3810410259127, "location": "8c44c1a8a8e41ff", "name": "long-chartreuse-goat", "nonce": 4, "owner": "13YuCz3mZ55HZ6hJJvQHCZXGgE8ooe2CSvbtSHQR3m5vZ1EVCNZ", "score": 0.05584716796875, "score_update_height": 290195, "status": { "height": 468407, "online": "online" }, "witness_for": "112hYxknRPeCP9PLtkAy3f86fWpXaRzRffjPj5HcrS7qePttY3Ek", "witness_info": { "first_time": 1583557733646152170, "histogram": { "-100": 1, "-108": 7, "-116": 10, "-124": 2, "-132": 0, "-60": 0, "-68": 0, "-76": 0, "-84": 0, "-92": 0, "28": 2 }, "recent_time": 1586567745906235190 } } ]}

Get Location

Get geographic information for a given location.

Path Parameters

Response

javascript
{ "data": { "city_id": "c2FuIGpvc2VjYWxpZm9ybmlhdW5pdGVkIHN0YXRlcw", "location": "8c28347213117ff", "long_city": "San Jose", "long_country": "United States", "long_state": "California", "long_street": "Rainbow Drive", "short_city": "San Jose", "short_country": "US", "short_state": "CA", "short_street": "Rainbow Dr" }}

Current Oracle Price

The current Oracle Price in $USD and at which block it took effect. The last 7 digits are decimals, cent denominations.

Response

javascript
{ "data": { "price": 167000000, "block": 471570 }}

Current and Historical Oracle Prices

The current and historical Oracle Prices and at which block they took effect. This route is paged using a cursor.

Query Parameters

Response

javascript
{ "data": [ { "price": 167000000, "block": 471570 }, { "price": 169630000, "block": 471540 } ], "cursor": "eyJiZWZvcmUiOjQ2NjE5MH0"}

Oracle Price Stats

Gets statistics on Oracle prices.

Query Parameters

Response

javascript
{ "data": { "avg": 12.433719079615384, "max": 20.0, "median": 12.53731614, "min": 6.0, "stddev": 3.50807814 }, "meta": { "max_time": "2021-04-20T15:52:28Z", "min_time": "2021-03-21T15:52:28Z" }}

Oracle Price at a Specific Block

Provides the oracle price at a specific block and at which block it initially took effect.

Path Parameters

Response

javascript
{ "data": { "price": 167000000, "block": 471570 }}

List Activity for a Specific Oracle

Lists price report transactions for the given oracle key. This route is paged using a cursor.

Path Parameters

Query Parameters

Response

javascript
{ "data": [ { "type": "price_oracle_v1", "time": 1622481773, "public_key": "145J6Aye86pKTJrUHREiXu7qqppZBcWY1bvWo8id7ZjxyuainYj", "price": 1586445000, "height": 866243, "hash": "d-2h0NpDcmF2zZrFkepS6KMDgQfgXxnmtN70vRboLkE", "fee": 0, "block_height": 866240 }, { "type": "price_oracle_v1", "time": 1622478285, "public_key": "145J6Aye86pKTJrUHREiXu7qqppZBcWY1bvWo8id7ZjxyuainYj", "price": 1621738000, "height": 866200, "hash": "d_VJbYy6bwRt2LbsN6XpghDljY-AC9pZCPbWQMjWWtg", "fee": 0, "block_height": 866198 } ], "cursor": "eyJ0eXBlcyI6InByaWNlX29yYWNsZV92MSIsIm1pbl9ibG9jayI6MzY2MjgzLCJibG9jayI6ODY2MjAwLCJhbmNob3JfYmxvY2siOjg2NjIwMH0"}

Get Predicted HNT Oracle Prices

This returns a list of expected times when the Oracle Price is expected to change.The blockchain operates in β€œblock-time”, meaning that blocks can come out at some schedule close to 1 per minute. Oracles report in β€œwall-clock-time”, meaning they report what they believe the price should be.If the route returns one or more prices and times, it indicates that the chain is expected to adjust the price (based on Oracle reports) no earlier than the indicated time to the returned price.NOTE: A prediction may not be seen in the blockchain if they are close together (within 10 blocks) since block times may cause the blockchain to skip to a next predicted price. If no predictions are returned the current HNT Oracle Price is valid for at least 1 hour.

Response

javascript
{ "data": [ { "price": 47000000, "time": 1594410146 } ]}

List OUIs

Lists all OUI transactions known to the blockchain

Query Parameters

Response

javascript
{ "data": [ { "subnets": [ { "mask": 8388606, "base": 2080 } ], "owner": "13o9kcgQQTLPGZMej8ya3RjRBWytJnGZkiLyruu4J9dqXgEDyvZ", "oui": 7, "nonce": 0, "block": 762430, "addresses": [] }, { "subnets": [ { "mask": 8388606, "base": 2072 } ], "owner": "13HWrdkMoooYJEYz8LjKWzfK1oZifCzwxPaCnV9XDJbC5Gso1ic", "oui": 6, "nonce": 1, "block": 762430, "addresses": [] }, { "subnets": [ { "mask": 8388606, "base": 2064 } ], "owner": "11P9o2DQNqkQ5GU6RTGcdUbRRtjc3syyhN29nFvm4ZfuhMnHj4S", "oui": 5, "nonce": 1, "block": 762430, "addresses": [] }, { "subnets": [ { "mask": 8388606, "base": 2056 } ], "owner": "11xHXS5AgLyjYRCJ4ctcWcsMRULS8jro9Pb1GPaTG1neGk1dNcf", "oui": 4, "nonce": 1, "block": 762430, "addresses": [] }, { "subnets": [ { "mask": 8388606, "base": 2048 } ], "owner": "14oSuAgRmAFPFPZRY1MUwir5AJSLGkaXHzuSZJ92BuYCfLMN1Et", "oui": 3, "nonce": 3, "block": 762430, "addresses": [] }, { "subnets": [ { "mask": 8388352, "base": 1024 } ], "owner": "1124CJ9yJaHq4D6ugyPCDnSBzQik61C1BqD9VMh1vsUmjwt16HNB", "oui": 2, "nonce": 8, "block": 762430, "addresses": [] }, { "subnets": [ { "mask": 8388352, "base": 0 } ], "owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc", "oui": 1, "nonce": 0, "block": 762430, "addresses": [ "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE" ] } ],"cursor": "eyJiZWZvcmUiOjQ2NjE5MH0"}

Get an OUI

Returns information for a specific OUI.

Path Parameters

Response

javascript
{ "data": { "subnets": [ { "mask": 8388352, "base": 1024 } ], "owner": "13DKnYxcXXEbqfT257cpmszpbdPsDX4vd3kY8Df5rxgQHHMdyPS", "oui": 2, "nonce": 90, "block": 867648, "addresses": [ "1124CJ9yJaHq4D6ugyPCDnSBzQik61C1BqD9VMh1vsUmjwt16HNB" ] }}

Get last assigned OUI

Returns the last assigned OUI transaction.

Response

javascript
{ "data": { "subnets": [ { "mask": 8388352, "base": 2080 } ], "owner": "13DKnYxcXXEbqfT257cpmszpbdPsDX4vd3kY8Df5rxgQHHMdyPS", "oui": 7, "nonce": 0, "block": 762431, "addresses": [ "" ] }}

Get OUseI Stats

Returns stats for the registered OUIs.

Respon

javascript
{ "data": { "count": 7 }}

Pending Transaction Status

Fetches the status for a given pending transaction hash. Multiple transactions for the same hash may be returned.

Path Parameters

Response

javascript
{ "data": [ { "updated_at": "2020-07-29T00:44:13.578098Z", "type": "payment_v2", "txn": { "type": "payment_v2", "payments": [ { "payee": "13FkKYnwHPoa6F7K23jJ7j2WNg9cMPsznJ7i4c9ysCwLoS8vx3E", "amount": 100000000 } ], "payer": "14h5MCATzJAB88gGBph8YtPM9539FdyBnMdTt7sYxg4Ts1D1aW3", "nonce": 7, "hash": "q7pnrm2LvPoZKclF4f2BB6AmcnD0SORECgq9VbNLir4", "fee": 35000 }, "status": "pending", "hash": "q7pnrm2LvPoZKclF4f2BB6AmcnD0SORECgq9VbNLir4", "failed_reason": "", "created_at": "2020-07-29T00:44:11.516601Z" } ]}

Reward Totals

Returns the total rewards for the whole network in a given timeframe.The results can also be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed by time. Valid bucket values include hour, day and week).

Query Parameters

Response

javascript
{ "meta": { "min_time": "2021-05-25T01:14:06Z", "max_time": "2021-05-26T01:14:06Z" }, "data": { "total": 138754.62740928, "sum": 13875462740928, "stddev": 1002.93808104, "min": 3581.01850809, "median": 4233.79629017, "max": 8585.64812366, "avg": 4475.95572288 }}

Demo to preview the settings:

Share
Content