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 Response
Last time to include in height search.
Copy {
"data" : {
"height" : 644081
}
} Block Stats
Get statistics on block production times.
Copy {
"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 Response
Cursor for page to fetch.
Copy {
"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 block at height
Query Parameters Response
Copy {
"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 Response
Cursor for page to fetch.
Copy {
"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 Parameters Response
Block hash for the block to fetch.
o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg
Copy {
"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 Response
Block hash for the block to fetch.
o5o8cBL1Zvp1KmA1d8vYJ38wXXWVxf1HW2e1uZxVJYg
Cursor for page to fetch.
Copy {
"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
Cursor for page to fetch. Note: The cursor for accounts is valid for a limited time.
eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0
Response
Copy {
"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
Number of accounts to return. Default 100, max 100.
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of hotspots to fetch.
Response
Copy {
"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.
https://docs.helium.com/use-the-network/buy-an-oui/
Path Parameters
13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc
Query Parameters
Cursor for the next page of OUIs to fetch.
Response
Copy {
"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
13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx
Query Parameters
Cursor for the next page of activity to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"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 Parameters
13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx
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
Comma separated list of transaction types.
Response
Copy {
"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.
https://docs.helium.com/blockchain/consensus-protocol/
Path Parameters
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of elections to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of challenges to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
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
First time to include rewards sum for.
Last time to include rewards for.
Response
Copy {
"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
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Response
Copy {
"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
Term to limit the list of cities with.
Cursor for page to fetch.
eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ
Response
Copy {
"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
The id for the city are returned by the cities list.
c2FpbnRlLW1hcmllLWF1eC1jaMOqbmVzZ3JhbmQgZXN0ZnJhbmNl
Cursor for page to fetch.
eyJyYW5rIjoiQWx2YSIsImNpdHlfaWQiOiJhbHZhZmxvcmlkYXVuaXRlZCBzdGF0ZXMifQ
Response
Copy {
"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
Cursor for page to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
Response
Copy {
"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
Address of hotspot to fetch.
11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db
Response
Copy {
"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 of hotspot(s) to fetch.
Response
Copy {
"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
Latitude of the location to search around.
Longitude of the location to search around.
Distance (in meters) from location to search within.
Cursor for page to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
Response
Copy {
"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
Latitude of the south-west corner.
Longitude of the south-west corner.
Latitude of the north-east corner.
Longitude of the north-east corner.
Cursor for page to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
Response
Copy {
"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
The h3 index to fetch hotspots for.
Response
Copy {
"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
B58 address of the hotspot.
11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db
Query Parameters
Cursor for page of results to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
Response
Copy {
"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
11yTLDH2QbVLyRnBykzdLLP2j2DoAzjSp3obNrnxhUXpVdaYCZF
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
Comma separated list of transaction types.
Response
Copy {
"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
B58 address of the hotspot to look up.
11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE
Query Parameters
Cursor for page of results to fetch.
eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0
Response
Copy {
"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
Copy {
"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
B58 address of the hotspot to look up.
11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ
Query Parameters
Cursor for page of results to fetch.
eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwfQ
Response
Copy {
"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
B58 address of the hotspot to look up.
11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ
Query Parameters
Cursor for page of results to fetch.
eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwfQ
Last timestamp to include rewards for.
ISO8601 timestamp or relative time
First timestamp to include rewards for.
ISO8601 timestamp or relative time
Response
Copy {
"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
B58 address of the hotspot to look up.
11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ
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
First timestamp to include rewards for.
ISO8601 timestamp or relative time
Last timestamp to include rewards for.
ISO8601 timestamp or relative time
Response
Copy {
"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
B58 address of the hotspot to look up.
11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ
Response
Copy {
"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
Copy {
"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
Copy {
"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
Returned from an initial query, allowing client to fetch more results.
Response
Copy {
"data": [
{
"price": 167000000,
"block": 471570
},
{
"price": 169630000,
"block": 471540
}
],
"cursor": "eyJiZWZvcmUiOjQ2NjE5MH0"
} Oracle Price Stats
Gets statistics on Oracle prices.
Query Parameters
First time to include in stats.
ISO8601 timestamp or relative time
Last time to include in stats.
ISO8601 timestamp or relative time
Response
Copy {
"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
The block to get the HNT Oracle Price at.
Response
Copy {
"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
The public key of the oracle.
145J6Aye86pKTJrUHREiXu7qqppZBcWY1bvWo8id7ZjxyuainYj
Query Parameters
Cursor for the next page to fetch.
eyJ0eXBlcyI6InByaWNlX29yYWNsZV92MSIsIm1pbl9ibG9jayI6MzY2MjgzLCJibG9jayI6ODY2MjAwLCJhbmNob3JfYmxvY2siOjg2NjIwMH0
Response
Copy {
"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
Copy {
"data": [
{
"price": 47000000,
"time": 1594410146
}
]
}
List OUIs
Lists all OUI transactions known to the blockchain.
Query Parameters
Cursor for page of results to fetch.
Response
Copy {
"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
Copy {
"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
Copy {
"data": {
"subnets": [
{
"mask": 8388352,
"base": 2080
}
],
"owner": "13DKnYxcXXEbqfT257cpmszpbdPsDX4vd3kY8Df5rxgQHHMdyPS",
"oui": 7,
"nonce": 0,
"block": 762431,
"addresses": [
""
]
}
} Get OUI Stats
Returns stats for the registered OUIs.
Response
Copy {
"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
Hash of the pending transaction to fetch.
q7pnrm2LvPoZKclF4f2BB6AmcnD0SORECgq9VbNLir4
Response
Copy {
"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
First time to include rewards for.
Last time to include rewards for.
Response
Copy {
"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
}
}