Link to plugin page: https://zeroqode.com/plugin/helium-blockchain-api-1625574636597x896820748219226100
Demo to preview the settings
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 the 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
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
requiredBlockchain 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
requiredBlockchain Height.
644081
number
cursor
optionalCursor 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
requiredBlock 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
requiredBlock hash for the block to fetch.
o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg
text
cursor
optionalCursor 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
optionalCursor 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
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
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
Name
Tags
Description
Example
Type
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
Name
Tags
Description
Example
Type
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
Name
Tags
Description
Example
Type
****cursor****
optionalCursor for the next page of activity to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
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
Name
Tags
Description
Example
Type
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
Name
Tags
Description
Example
Type
optional
Cursor for the next page of elections to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
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
Name
Tags
Description
Example
Type
optional
Cursor for the next page of challenges to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
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
Name
Tags
Description
Example
Type
optional
Cursor for the next page of challenges to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
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
Name
Tags
Description
Example
Type
optional
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcw
ISO8601 timestamp or relative time
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
Name
Tags
Description
Example
Type
required
First time to include rewards sum for.
2020-08-27T00:00:00Z
ISO8601 timestamp or relative time
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
Name
Tags
Description
Example
Type
optional
Cursor for page to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
text
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
Name
Tags
Description
Example
Type
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
Name
Tags
Description
Example
Type
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
Name
Tags
Description
Example
Type
optional
Cursor for page to fetch
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
text
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
Name
Tags
Description
Example
Type
optional
Cursor for page to fetch
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn
text
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
Name
Tags
Description
Example
Type
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
Name
Tags
Description
Example
Type
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for page of results to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
text
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
Name
Tags
Description
Example
Type
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 }}