Hotspots
List Hotspots
GET https://api.helium.io/v1/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.
The filter_modes parameter can be used to filter hotspot by how they were added to the blockchain.
Supported values are full, dataonly, or light. A comma separated list (no whitespace) can be
used to filter for multiple modes.
- Request
- Response
Query Parameters
| param | Type | Note |
|---|---|---|
| cursor (optional) | string | Cursor for the page to fetch |
| filter_modes (optional) | string | Filter hotspot types |
200: OK
Hotspots successfully retrieved.
{
"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
},
"reward_scale": 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
},
"reward_scale": 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
GET https://api.helium.io/v1/hotspots/:address
Fetch a hotspot with a given address.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (optional) | string | Address of hotspot to fetch |
200: OK
{
"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",
"reward_scale": 0.25,
"status": {
"height": 394065,
"online": "offline"
}
}
}
Hotspots for Name
GET https://api.helium.io/v1/hotspots/name/: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.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| name | string | Name of hotspot(s) to fetch |
200: OK
{
"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",
"reward_scale": 0.25,
"status": {
"height": 394065,
"online": "offline"
}
}
]
}
Hotspot Name Search
GET https://api.helium.io/v1/hotspots/name?search=<term>
Fetch the hotspots which match a search term in the given search term query parameter. The search
parameter needs to be at least one character, with 3 or more recommended.
- Request
- Response
Query Parameters
| param | Type | Note |
|---|---|---|
| search | string | The name fragment to search for |
200: OK
Search results for search=clever-gray
{ [74/4462]
"data": [
{
"address": "112sBjb6sHaEf9MbCaDEH3k4yFM4e2rHZxGTzpV9RTtfDqxX9CCC",
"block": 768022,
"block_added": 750477,
"geocode": {
"city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz",
"long_city": "San Francisco",
"long_country": "United States",
"long_state": "California",
"long_street": "Cerritos Avenue",
"short_city": "SF",
"short_country": "US",
"short_state": "CA",
"short_street": "Cerritos Ave"
},
"last_change_block": 750502,
"last_poc_challenge": null,
"lat": 37.72614653945264,
"lng": -122.47020118178871,
"location": "8c28309510699ff",
"name": "clever-grape-boa",
"nonce": 1,
"owner": "13NrTQR32bCjPejvzLwKmBjeieZykBVbmoR7FKqKHFjVJocecak",
"reward_scale": 1.0,
"status": {
"height": 745390,
"listen_addrs": null,
"online": "offline"
},
"timestamp_added": "2021-03-08T16:24:54.000000Z"
},
{
"address": "11ZbFBWirta2WCW14SDoTbFpXa8C6ZYoN4QuWL6dQDLiHajmHce",
"block": 768022,
"block_added": 742230,
"geocode": {
"city_id": "cGhpbGFkZWxwaGlhcGVubnN5bHZhbmlhdW5pdGVkIHN0YXRlcw",
"long_city": "Philadelphia",
"long_country": "United States",
"long_state": "Pennsylvania",
"long_street": "City Avenue",
"short_city": "Philadelphia",
"short_country": "US",
"short_state": "PA",
"short_street": "City Ave"
},
"last_change_block": 742262,
"last_poc_challenge": null,
"lat": 40.00814845396687,
"lng": -75.20963332539121,
"location": "8c2a1348e5a4bff",
"name": "clever-graphite-hyena",
"nonce": 1,
"owner": "148f6FrFVro4Yoc9FBoWRPVrEMusDGWZew2zgeSWBybK2CHmNKW",
"reward_scale": 1.0, [18/4462]
"status": {
"height": 738310,
"listen_addrs": null,
"online": "offline"
},
"timestamp_added": "2021-03-01T19:58:41.000000Z"
},
{
"address": "11QpxYxhrhG3E2FbuJSV5mgQW6cyp2rXMrjYoBN9y29e2XegDWY",
"block": 768022,
"block_added": 143709,
"geocode": {
"city_id": "bGl2ZXJtb3JlY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM",
"long_city": "Livermore",
"long_country": "United States",
"long_state": "California",
"long_street": "Glasgow Circle",
"short_city": "Livermore",
"short_country": "US",
"short_state": "CA",
"short_street": "Glasgow Cir"
},
"last_change_block": 767734,
"last_poc_challenge": 767734,
"lat": 37.69373462966,
"lng": -121.75659980161144,
"location": "8c2830d36ba49ff",
"name": "clever-green-beetle",
"nonce": 4,
"owner": "13auTVmhWAhV6MV6hQ9huecHhLZTXH1MbUnMTKEBtTFJVaC5bic",
"reward_scale": 0.5555572509765625,
"status": {
"height": 767999,
"listen_addrs": [
"/p2p/112qupChNrC4UVv5dHztTrtp6UWH6ooa9WQCbmXFuLxDHow82CY3/p2p-circuit/p2p/11QpxYxhrhG3E2FbuJSV5mgQW6cyp2rXMrjYoBN9y29e2XegDWY"
],
"online": "online"
},
"timestamp_added": "2019-12-21T08:26:08.000000Z"
},
{
"address": "112pCaom9T5B7bmK8p6CRhBtWrxM1DEM2p4gjh44azuwjCzex2oE",
"block": 768022,
"block_added": 553919,
"geocode": {
"city_id": "ZGVhcmJvcm4gaGVpZ2h0c21pY2hpZ2FudW5pdGVkIHN0YXRlcw",
"long_city": "Dearborn Heights",
"long_country": "United States",
"long_state": "Michigan",
"long_street": "Nightingale Street",
"short_city": "Dearborn Heights",
"short_country": "US",
"short_state": "MI",
"short_street": "Nightingale St"
},
"last_change_block": 767950,
"last_poc_challenge": 767950,
"lat": 42.33796350854145,
"lng": -83.28504344820625,
"location": "8c2ab2cd14833ff",
"name": "clever-ginger-meerkat",
"nonce": 3,
"owner": "13NQcBoZyngE8FbjxJZ1bHE2m7SLQyMPSMDAL3MRAquzgGttZN1",
"reward_scale": 1.0,
"status": {
"height": 767963,
"listen_addrs": [
"/p2p/11254xZhWECFDcvZLPJEj6YmaWvTeUL1yrWdbTEVcV34C83am7w9/p2p-circuit/p2p/112pCaom9T5B7bmK8p6CRhBtWrxM1DEM2p4gjh44azuwjCzex2oE"
],
"online": "online"
},
"timestamp_added": "2020-10-22T16:49:16.000000Z"
}
]
}
Hotspot Location Distance Search
GET https://api.helium.io/v1/hotspots/location/distance
Fetch the hotspots which are within a given number of meters from the given lat and lon
coordinates. This route is paged using a cursor.
- Request
- Response
Query Parameters
| param | Type | Note |
|---|---|---|
| lat | float | Latitude of the location to search around |
| lon | float | Longitude of the location to search around |
| distance | integer | Distance (in meters) from location to search within |
200: OK
Search results for ?lat=38.12129445739087&lon=-122.52885074963571&distance=1000
{
"data": [
{
"lng": -122.52885074963571,
"lat": 38.12129445739087,
"timestamp_added": "1970-01-01T00:00:00.000000Z",
"status": {
"online": "online",
"listen_addrs": ["/ip4/76.102.181.228/tcp/44158"],
"height": 771115
},
"reward_scale": 0.5,
"owner": "13buBykFQf5VaQtv7mWj2PBY9Lq4i1DeXhg7C4Vbu3ppzqqNkTH",
"nonce": 0,
"name": "curly-berry-coyote",
"location": "8c2830aa2529dff",
"last_poc_challenge": 771113,
"last_change_block": 771113,
"geocode": {
"short_street": "Andale Ave",
"short_state": "CA",
"short_country": "US",
"short_city": "Novato",
"long_street": "Andale Avenue",
"long_state": "California",
"long_country": "United States",
"long_city": "Novato",
"city_id": "bm92YXRvY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 1,
"block": 771120,
"address": "112Z6fYnkQa8VAyMWHoaZJVzrxbWPoJV2NCfdZmaNoG1pYxWdGwD"
},
{
"lng": -122.52885074963571,
"lat": 38.12129445739087,
"timestamp_added": "1970-01-01T00:00:00.000000Z",
"status": {
"online": "online",
"listen_addrs": ["/ip4/76.102.181.228/tcp/44160"],
"height": 768806
},
"reward_scale": 0.5,
"owner": "13buBykFQf5VaQtv7mWj2PBY9Lq4i1DeXhg7C4Vbu3ppzqqNkTH",
"nonce": 0,
"name": "immense-eggplant-stallion",
"location": "8c2830aa2529dff",
"last_poc_challenge": 768733,
"last_change_block": 771071,
"geocode": {
"short_street": "Andale Ave",
"short_state": "CA",
"short_country": "US",
"short_city": "Novato",
"long_street": "Andale Avenue",
"long_state": "California",
"long_country": "United States",
"long_city": "Novato",
"city_id": "bm92YXRvY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 1,
"block": 771120,
"address": "11VKaN7fEvDm6NaGhcZtNSU1KAQQmTSwuuJsYYEqzh8mSWkoEUd"
}
]
}
Hotspot Location Box Search
GET https://api.helium.io/v1/hotspots/location/box
Fetch the hotspots which are within a given geographic boundary indicated by it's south-wesetern and
north-eastern co-ordinates. This route is paged using a cursor.
- Request
- Response
Query Parameters
| param | Type | Note |
|---|---|---|
| swlat | float | Latitude of the south-west corner |
| swlon | float | Longitude of the south-west corner |
| nelat | float | Latitude of the north-east corner |
| nelon | float | Longitude of the north-east corner |
200: OK
Search results for ?swlat=38.0795392&swlon=-122.5671627&nelat=38.1588012&nelon=-122.5046937
{
"data": [
{
"lng": -122.51688114452725,
"lat": 38.109947587584905,
"timestamp_added": "2019-08-02T00:13:25.000000Z",
"status": {
"online": "online",
"listen_addrs": ["/ip4/64.7.85.50/tcp/28762"],
"height": 769399
},
"reward_scale": 1,
"owner": "13fTdByCpUDRKuVh4VZcUWh7rdehrh4UfjMdFt17ew4h93nD86s",
"nonce": 9,
"name": "agreeable-walnut-weasel",
"location": "8c2830ab51653ff",
"last_poc_challenge": 750521,
"last_change_block": 750521,
"geocode": {
"short_street": "Lockton Ln",
"short_state": "CA",
"short_country": "US",
"short_city": "Novato",
"long_street": "Lockton Lane",
"long_state": "California",
"long_country": "United States",
"long_city": "Novato",
"city_id": "bm92YXRvY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 3805,
"block": 771120,
"address": "11tWRj2Qhnn177iVYm3KUmbPdMyhRfeqHqk9kCyiR7y57hdG9JA"
},
{
"lng": -122.55193831997157,
"lat": 38.1204024903364,
"timestamp_added": "2019-08-01T15:44:31.000000Z",
"status": {
"online": "online",
"listen_addrs": ["/ip4/76.102.181.228/tcp/44159"],
"height": 771118
},
"reward_scale": 1,
"owner": "13buBykFQf5VaQtv7mWj2PBY9Lq4i1DeXhg7C4Vbu3ppzqqNkTH",
"nonce": 7,
"name": "magic-rainbow-wasp",
"location": "8c2830aa2a63dff",
"last_poc_challenge": 771079,
"last_change_block": 771079,
"geocode": {
"short_street": "Morning Star Ct",
"short_state": "CA",
"short_country": "US",
"short_city": "Novato",
"long_street": "Morning Star Court",
"long_state": "California",
"long_country": "United States",
"long_city": "Novato",
"city_id": "bm92YXRvY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 3301,
"block": 771120,
"address": "112aeWRZdyz61Y7EQeMbXwqERNMPnciDvsxyFmhz1UfA9hte4R4W"
},
{
"lng": -122.52885074963571,
"lat": 38.12129445739087,
"timestamp_added": "1970-01-01T00:00:00.000000Z",
"status": {
"online": "online",
"listen_addrs": ["/ip4/76.102.181.228/tcp/44158"],
"height": 771115
},
"reward_scale": 0.5,
"owner": "13buBykFQf5VaQtv7mWj2PBY9Lq4i1DeXhg7C4Vbu3ppzqqNkTH",
"nonce": 0,
"name": "curly-berry-coyote",
"location": "8c2830aa2529dff",
"last_poc_challenge": 771113,
"last_change_block": 771113,
"geocode": {
"short_street": "Andale Ave",
"short_state": "CA",
"short_country": "US",
"short_city": "Novato",
"long_street": "Andale Avenue",
"long_state": "California",
"long_country": "United States",
"long_city": "Novato",
"city_id": "bm92YXRvY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 1,
"block": 771120,
"address": "112Z6fYnkQa8VAyMWHoaZJVzrxbWPoJV2NCfdZmaNoG1pYxWdGwD"
},
{
"lng": -122.52885074963571,
"lat": 38.12129445739087,
"timestamp_added": "1970-01-01T00:00:00.000000Z",
"status": {
"online": "online",
"listen_addrs": ["/ip4/76.102.181.228/tcp/44160"],
"height": 768806
},
"reward_scale": 0.5,
"owner": "13buBykFQf5VaQtv7mWj2PBY9Lq4i1DeXhg7C4Vbu3ppzqqNkTH",
"nonce": 0,
"name": "immense-eggplant-stallion",
"location": "8c2830aa2529dff",
"last_poc_challenge": 768733,
"last_change_block": 771071,
"geocode": {
"short_street": "Andale Ave",
"short_state": "CA",
"short_country": "US",
"short_city": "Novato",
"long_street": "Andale Avenue",
"long_state": "California",
"long_country": "United States",
"long_city": "Novato",
"city_id": "bm92YXRvY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 1,
"block": 771120,
"address": "11VKaN7fEvDm6NaGhcZtNSU1KAQQmTSwuuJsYYEqzh8mSWkoEUd"
}
]
}
Hotspots for H3 Index
GET https://api.helium.io/v1/hotspots/hex/:h3_index
Fetch the hotspots which are in the given h3 index. The supported h3 indices are currently limited to resolution 8.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| h3_index | string | The h3 index to fetch hotspots for |
Fetch all hotspots in h3 index: 882aa38c2bfffff
{
"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
GET https://api.helium.io/v1/hotspots/:address/activity
caution
The /activity route will be deprecated on May 1, 2022 and will be replaced by
/roles, described below
Lists all blockchain transactions that the given Hotspot was involved in. This route is paged using
a cursor.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (optional) | string | B58 address of the hotspot |
Query Parameters
| param | Type | Note |
|---|---|---|
| cursor (optional) | string | Cursor for page of results to fetch |
| filter_types (optional) | string | Comma separated list of transaction types |
| min_time (optional) | string | First time to include data for |
| max_time (optional) | string | Last time to include data for |
| limit (optional) | number | Maximum number of items to return |
200: OK
This lists the activity for a Hotspot which only had two transactions at the time of the request.
Transaction Units
Remember that transaction units are in bones. Read more
here
{
"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"
}
]
}
Hotspot Roles
GET https://api.helium.io/v1/hotspots/:address/roles
Lists all blockchain transactions that the given Hotspot was involved in. This route is paged using
a cursor.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (optional) | string | B58 address of the hotspot |
Query Parameters
| param | Type | Note |
|---|---|---|
| cursor (optional) | string | Cursor for page of results to fetch |
| filter_types (optional) | string | Comma separated list of transaction types |
| min_time (optional) | string | First time to include data for |
| max_time (optional) | string | Last time to include data for |
| limit (optional) | number | Maximum number of items to return |
200: OK
This lists the activity for a Hotspot which only had two transactions at the time of the request.
{
"data": [
{
"type": "assert_location_v2",
"time": 1644023217,
"role": "gateway",
"height": 1212339,
"hash": "DXciS1wFRf4CAfK_FPl-nE3l_YhisFibOmY2vXE0e3s"
},
{
"type": "add_gateway_v1",
"time": 1644023156,
"role": "gateway",
"height": 1212338,
"hash": "VSO7aKH9uiCuWUNzb5rPddlq-m-kvaMeVeufUQisjbo"
}
]
}
Hotspots Roles Counts
GET https://api.helium.io/v1/hotspots/:address/roles/count
Count transactions that indicate a Hotspot as a participant.
The results are a map keyed by the given filter_types and the count of transaction of that type.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | string | Hotspot B58 address to fetch counts for |
Query Parameters
| param | Type | Note |
|---|---|---|
| filter_types | string | Comma separated list of transaction types |
200: OK
Fetch counts with filter_types=assert_location_v1 for hotspot
/11yTLDH2QbVLyRnBykzdLLP2j2DoAzjSp3obNrnxhUXpVdaYCZF
{
"data": {
"assert_location_v1": 2
}
}
Hotspot Elections
GET https://api.helium.io/v1/hotspots/:address/elections
Lists the consensus group transactions that the given hotspot was involved in. This route is paged
using a cursor.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | number | B58 address of the hotspot to look up |
Query Parameters
| param | Type | Note |
|---|---|---|
| cursor (optional) | string | Cursor for the page to fetch |
| min_time (optional) | string | First time to include data for |
| max_time (optional) | string | Last time to include data for |
| limit (optional) | number | Maximum number of items to return |
200: OK
Fetches consensus groups that the hotspot with address
11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE was a part of
Transaction Units
Remember that transaction units are in bones. Read more
here
{
"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": "8_UTNYLnSwLmYKI4n5OzDdjOIkYYtBREvBGthDGFMZ0",
"height": 372519,
"members": [
"112mRr9U2QkP5svLtTZjnGZ9qMwExoY8zz3Y5KyNYh6eKsvhsaxT",
"11edHhAK28WHFMZ6D6HTKnzer9jXNRq57ghzxv1ij7ERPMXRKnH",
"119hQxQAhkGT7dWMPXoPH4E811PzJB9PsgVjsTcUCDLPaCT9aNP",
"11gQQknec6vuRm8exJU4UG9pyT1e1NXr6yZV7sjPdCwvXaYCJBN",
"112VVqgL1LRxy6jhAM4AtNVa4qDcw1KmfGf4HjkjQAszo23EqYYY",
"112L7A2Xpkh7fjKjuaTfq3WgEn9nnAXg2M7BTWsR9dYvn4eopguz",
"11eMofv6oYA3Y7LE4EZxJzwxzyjNHdedKSMNDP5y8pCuvnaMRQ6",
"11Qg88VmPkmv2oZggft8THbNhMKtnhUjBVPFJdy33q64GFu5JPN",
"11tWRj2Qhnn177iVYm3KUmbPdMyhRfeqHqk9kCyiR7y57hdG9JA",
"11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE",
"112hMyXUsTjZV68R5GpP1CMPeyF546zQjnfi9mdUiwBxNqbi2Lw5",
"112HwmAx3XVW2NUGWa9Gk1yB2zkxXE6Bv4FXgop5Was5Msa7SUcH",
"1129waT8yUcphrcgYecpoXQtSGh9HS7NZfc6EfBHhQgYKJGibBHH",
"11wevymXjkG1zPE717qjb8hJQpUaJZMMp4kr3AegmTQpu1jhZ7e",
"112Hs1kfxaER29V3C4sebiiJJao3SYB91TJ8oRgmqnG1JSavHj6n",
"11263kd7cLpvrfBDv8GLEF5kq37kjxHFYE6t8KLEpe8fnwdLoUEx"
],
"proof": "g1AAAAdHeJxN1Hk8FGgYB3AGg8i4rQxGo4l1jWbaZnJXJPcRhjFGrCss64qhXFvIyFUYDLJuRhErd8mRotWKYVCKkdw3ww7LH8P-9f7z-7zf93mf53192NjYBD0BvoeLHNvF138gdttfr05FveHN9mks0lxsJ7VzG4eQrCl3xyp0N49S1-H6ADm2UVAcNuF9ZM2aAXbdRDoq8VbCTTnj5K9a53-1WW95ROYEQEJxn5MMV3qK6gNfQJKdZ0bBVOIaf3XDd2Iugb-xFCrNMmP9Fcl4R0XN0L8oUADcCVIjJDNnZtJB7YBxtbtP3U9jmRCZUyubTc95JWbjw3vNhTcn1W46YGA-AKiDOFvH9C5f6eGpyDTp2GGL9jxzG8LZmoOfXR7-FjDDkXrjCb6hSDZzwNGPZQZtKFwKwGdJLc-PMMDzZOwiaP5RXBFE31tHx538hTp7lDKEGxzu-L15ySrH9ZRr18s4Pj1T_30YvDSjudhRIlwBjPgYHIc5jGxtL2MKVegQy5V4VIWcupuHJRFKF6haR7q7tcxV_57NQm38OHCdCzu0Lu6HPMFS-XQrDcboae26OCjyI6HTc3LhBG1LAPKXXx2xTd0fPl2u_LFAuB0mnG7ILryz0tMasNVUcxj5ELFwcC5plUbWLRzopszZckcnJPYIxf8d3zSjt8P57RYLLd_7DkweMNQerq7d5tlMp04DKDZmKgL6a4JpB1cGu21OOvqAi2l31WXY6vz1vC74N4HyOsE30WY-dQ5TyZQUDKCQBwDR9ae-hABEwd4_AXyT6RnMsVuLn6otvEqbLiFFaLnmFJbZ6cFPfZNdj1JReLDLNYG6hXOYXttW68aNlpEcbhgthJwUGiOJAF3OXhgqmPcIliEW_UD97s-7h5nHDbVa64Ubg18cRkZqCR_qRO_CHPnKwp2DltgmwftAo43xsyZ9G-PFLTwfWWiygspbR66yFHBjxzZophpzO1rHbesCIz1Uz_RCZp2l1VHKAH4NADkVUd8d6xkUMoAcaCOuNWL7mvSlraD5nzAWSvGKT6KzABAJjZTu1IE7akS9KHRurZnpngQCGfY-t3_gfUHBGWBYKouMkEQz5OFSImFaHq1T9qBB9lKMxtmJBo3nIMcNtRaXrWMSHa8r9vni-jUpdUmfFw8VSPNJb0gNBg90r4rXJ92QDh4HQHRUhGOQYaI42mQLORjHsPYN9MP5R0J6PKXcn9HGfDVY5DNRhNBFDk2XHRF5EZDgk158alwFNa3RGLZNy3l2IcTrpJ0VoUmOQys-_3BLj_XWfl6Se2WR64sWJ0z8YINAiI_HRgAQeSOP6ecxfa4LhXORS2IEQH8dPmXDNwM2I3TfVjPPtYFlZh54bF3d4rLlGjonLjZlx4G6JovlvKL2SnlcktMCC3M7MRdFcOopte_x9yoR0jFqbSnyId-wqspJYgolYCY6J4sAgHBadc2tpwSUvBYY2lC2G6O1ZBgtMytjLc4T-4tzdCEIllmhdE-7L1-RscnQ1x_sfwelBEl_Wvoqk6i5k2_SOQwfOhmhUdmLGOD3vKmGSK0SLeD-Hn-CkaXVZQulxitW3mqWCqKHkU5KuGEvO9W9Fl32UjHKcTDosXrhnXfMK8P7UQlAfC47C705SJXjexngN825HN-5y3BSxpLBmKq-O8zpyLdyVeO-xz-RLP26qxHvZfXyEFmeHmuxjWycbHGv8-24mrlt293Zko5Dk6QqnGkQsP3coQRW2e5JcaSD8n9SDkqMEBQV-DNLXkKJZYq066XBNrs_sIPlzu4bfZL2Av_ce2_36d-Lq70x_4QiVI9NaDPAf4aJd2KalnuN2XAkzRTYITe9nw50S-TEIbNFgEfXj3qQTKvUaFIiVXn2LwT_q-6soM046LVVyrd0QsJamlnmbHosb9Z1KKopY_pGOW_bXn1h5m9_bkeFHjCjicRMqXPHc-sj09xpTb7_ISRfqFY2HDg7vuVtZ29fy1gt-7zWp7-ffDjZSX3iCbvmncocha5C_eiRVeSzJ27LVZqqZp7-WGP5dhZpHxrtAo4o8Mo1rovkjO6z9oanvyM01vhAfVy6jEAU0-MyMW2TMl8rDZYvuWefVq62ec1FvIwuD_tWhHMoNkDQN46m7FHecuB6tbZhKIaZlRMgaULHvT13Rp_0KvLpmdE7b78Is8wvdo8ndvw8_ihwTkTIeudHZbdCCah_Q_gm7HUe3aUtN__vrSj300GaaGxQq0GL7mMz0DuJXrwfSryfK3aAkKZ6xgkAMVfp1lfC8_2CAvL8QGUG6mltQgPp-TeTSbwm3H5NmNbb_wG5EB0Z",
"time": 1592110088,
"type": "consensus_group_v1"
},
{
"delay": 5,
"hash": "MdGogde_J7Let1-D-FKR5LqAVWsC_dcTqI15ix8zPMY",
"height": 372486,
"members": [
"112mRr9U2QkP5svLtTZjnGZ9qMwExoY8zz3Y5KyNYh6eKsvhsaxT",
"11edHhAK28WHFMZ6D6HTKnzer9jXNRq57ghzxv1ij7ERPMXRKnH",
"119hQxQAhkGT7dWMPXoPH4E811PzJB9PsgVjsTcUCDLPaCT9aNP",
"11gQQknec6vuRm8exJU4UG9pyT1e1NXr6yZV7sjPdCwvXaYCJBN",
"112VVqgL1LRxy6jhAM4AtNVa4qDcw1KmfGf4HjkjQAszo23EqYYY",
"112L7A2Xpkh7fjKjuaTfq3WgEn9nnAXg2M7BTWsR9dYvn4eopguz",
"11eMofv6oYA3Y7LE4EZxJzwxzyjNHdedKSMNDP5y8pCuvnaMRQ6",
"11Qg88VmPkmv2oZggft8THbNhMKtnhUjBVPFJdy33q64GFu5JPN",
"11tWRj2Qhnn177iVYm3KUmbPdMyhRfeqHqk9kCyiR7y57hdG9JA",
"11ADL7tz5fazKdFM21kdo6K11k7bpjun6JwY22N4tx6ab6mjrYx",
"112Pah4kwPwuVmCTmD1T5tiM2YZTQ4MmoFg68zxwyZsiYVtk8Bx3",
"11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE",
"11knHXfj4QiwxtSajc6D8FQzpDZFCEL4Q2cF74K7Yu8Lp3pCXXu",
"112dDDJ8HCWR9qGC3jsm1UBBaVy2LgLu8Pryd4vNvHXhv8LL4gMW",
"112hMyXUsTjZV68R5GpP1CMPeyF546zQjnfi9mdUiwBxNqbi2Lw5",
"112HwmAx3XVW2NUGWa9Gk1yB2zkxXE6Bv4FXgop5Was5Msa7SUcH"
],
"proof": "g1AAAAdHeJxF1Hk81HkYB_Dxq9RE65YMdoaiiWEck9llUY5hQlnH5Jxicx-zaIxxM2Ijdsgx7mssxoQcLbs17hwTuTdCbRIh2lwjmp3-mPz1_efzer2_z_N8n68_CAQS9QYCeAcM5EiKc5eLLPEpuNIUczSObeuHzBwgtzb4K_m792BFmFZfUxikKQADJeR3riH3OHpSFZ4LtbFtybQPxJpPVclC07jw8-HG1AYACvTl18ogUNtV5e6gyfd4j8rRqKfek2rSFcDZrZYnjGt8s0Y12oBdDOdscUxNx54NKDFD5cc_vFZI0d8ttuyeRE4cmiUu1TdNt_8aPQ0zWPl3V9680GzZv5GLjXwtML1r84CjAkCv5BZN-CTbl6qhcMxs9p3TYef8HZdOzshcaEq1CkfP1vFND--ZPdTbEykDdrRTqUbK3vL1JoGzzDliBiLM5GfrxplDk6KtErUf1lqvdx2I0Q3qh-yMpMhMVyfjr0pQKp0R5BUAan10O-DeCu6Bm4XEnOCysTU9Gzhz4NFjcnFV1mam3YzBN7u9hKe68prRiPN39o7Nom-6Oi38t6PR6_qiiuZkgV0lfk2ZI814ZrMDEPnr9ojNspHU8V5lpzTWiEN-y4HE5fWNJhsddXMiLzKNdhQMCoZk0QlheS3JDR3DRooEOfwT37JfGCZzV0Vz-GidpLYY6oi--67EWQkR0ax-PDWpZiqj9YryznR-nRbR52vKDGkCQEm746NPnpf0K8uIYctpZqCuj680HOIUk5wv7feWppGhABSFoS6Ech5vFmmbQuek7t8RLmF3Rkvqv8oJyYMLSw9e5JOoDor2Hqvj45vYLnCef2uF_hqLxjp-hUizZUbN1BhtHdbZ4pkrqt6iqjx-ArGpY-pz63RfwkLz4n0NHZLc30nDF37iRZ6-wIAW_UvhSH2K5U81L21CTSF_eK6mELpn0uoT4OPn-Kh90BHX7tXd6Z7jd0_chhS__VmP8-KUQVOSks4Iudv71Sp_oFA3bCdLYFDrO0SyfQk43VDNcfLpPsIsuVpTxIltX05V5JkV8KOd0nWNPrr21aU3I0hcVSvW5n27y44GUmzZZsLIPN-0G5uCCf0ZHLRwdD25e4_jpuZcKHe9lh12sBDTB6t9GXBY6Hx3vt5_uHWC-Pi2TPmG-V7Ug2vygB50mrGSXUqEyCrxIv92N2hwwbQt0x22mM_grFE8TFMwMWqprGXn5nzRi3o0H00gwAvxLnB9UgtTCUC6QRvEFN5bW3ZOdSofY3m-Scz4VqiDi84rMueBxpJjmAh-9OJw5HJXG45Qdef2F7uUcFtdMs_MC4W0fNnvaD4i3AcnUgJ7mMaKi_TXW4wRxmPb9q1hOt8M3TyvG4zPhayv_MORWyl0XhNZSUuqgJr6GRp6Fs5PLR1uy3LqmB99BgcOeZlZ0e5x0RhenPJmcoh78mH7lNitG5LmAPSaltfmM-eCt1-cH-ukE2gWVpC4ja42Tcy9bLzLXIOsAN-ceE9XTEIr_ym5cVBa1vyu0TacS1fOOm7sIKZOIYb2Dh02N3MCEVL7235j1mYAa8pkcXlKRbbaUD-wuShM_sP8Myd_XiRdesLCt3L7Ouck9QxcoU2gRizbwUv1B5XAh5YHuj7ua3xUckUK7B2kOf_8QLXHg1MF-lHheTbNK9gps2t8gZUHs_m2LQGCWYIkLyNMjutDXxTdeSQA9Xdr4Zsh8I4aHEFNIV4FoDClXCPXRxuV2O8HrCSCqun03-333tV7HcsL-EzKcMZp8EkJ1qUM5a3eIQE5mOIX7Li8j9yF_ui90uG1j_3xoyRt9cPeprri9D4Npael34ZZDmiKYk7F31U80O2L6KaMZTpEs90BqIrbjdwmJsbeLsultfES5Kmu1rHPGE-SrOUn-IF8gSeHb7bscE8wXcQTa8mOWnUFtNo1oSC9PxZ71Lcv1-uKUwySDk2q9V0uZ5oxG59t0vUOeiuineOOwwUOyiu-1jFnqXXwfr8LcQ0DEWI9mLsB6_GXd62ov_3TgKUMovViLqFizcM1X_LNpcwEcC5GCd2WvWBRDX7yubksJ7B8J5bEPYhLTc2BnPv2bm_veJdHo9j22Gb17EcEPOGRX3CPhQKWalOq8vFdup4n71YF7xlp4vf8LB-RQ_w1C0GON4Z95IC5xEap0bEzvq65IXxzHnd_djfIi1JyI0X7e7_i2LzHSmT0PlFo1tEwLWp6_a9v4zxb0A4N00ct5chV2XOEbKK12qW5Zz-X5SSYxVx1L1KLAKCykVahSLTqvLrA3BFmovSCtHgOvjKNwV19C_41rY4u7Ps_lTspEA",
"time": 1592108023,
"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"
}
]
}
Currently Elected Hotspots
GET https://api.helium.io/v1/hotspots/elected
Returns the list of hotspots that are currently elected to the consensus group.
- Request
- Response
No Parameters
200: OK
{
"data": [
{
"lng": -121.85991310272425,
"lat": 37.71966414273407,
"status": {
"online": "online",
"height": 488792
},
"score_update_height": 488777,
"score": 0.9963226318359375,
"owner": "14S7ZHRYtCCLExgh5qJphfB25dZHn3Pfy6pBkXHNgG7WvkWxazS",
"nonce": 1,
"name": "genuine-grape-mockingbird",
"location": "8c2830d2334adff",
"geocode": {
"short_street": "Cranbrook Pl",
"short_state": "CA",
"short_country": "US",
"short_city": "Dublin",
"long_street": "Cranbrook Place",
"long_state": "California",
"long_country": "United States",
"long_city": "Dublin",
"city_id": "ZHVibGluY2FsaWZvcm5pYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 450212,
"block": 488901,
"address": "11A45JqGJ8Jnx9YnuncFYLtBj6Vn8nhcQTc6uh549QzqqFMc4F3"
},
{
"lng": -90.31235668207206,
"lat": 38.65572336414821,
"status": {
"online": "online",
"height": 488880
},
"score_update_height": 488872,
"score": 0.98834228515625,
"owner": "13FYzYCw1VMJzbFNAqNB7GDD2EWPB7uE82iHj33g5KrWyZAvpPm",
"nonce": 1,
"name": "polite-raspberry-newt",
"location": "8c2646260973bff",
"geocode": {
"short_street": "Washington Ave",
"short_state": "MO",
"short_country": "US",
"short_city": "University City",
"long_street": "Washington Avenue",
"long_state": "Missouri",
"long_country": "United States",
"long_city": "University City",
"city_id": "dW5pdmVyc2l0eSBjaXR5bWlzc291cml1bml0ZWQgc3RhdGVz"
},
"block_added": 459422,
"block": 488901,
"address": "11UeLFyfHaoL8U2oWmtkDYxSt37ZSd432Jnaa2Uy4rLSTHP5AiG"
},
{
"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": -84.14116349722525,
"lat": 34.099581418911974,
"status": {
"online": "online",
"height": 488880
},
"score_update_height": 488885,
"score": 0.9802703857421875,
"owner": "13Htq8exAPrLx35PhTJU4Tk2N7sGw1sdfLUtaCUcik7cZJQWQJJ",
"nonce": 1,
"name": "joyful-citron-walrus",
"location": "8c44c128eb151ff",
"geocode": {
"short_street": "Bradford Ln",
"short_state": "GA",
"short_country": "US",
"short_city": "Suwanee",
"long_street": "Bradford Lane",
"long_state": "Georgia",
"long_country": "United States",
"long_city": "Suwanee",
"city_id": "c3V3YW5lZWdlb3JnaWF1bml0ZWQgc3RhdGVz"
},
"block_added": 100661,
"block": 488901,
"address": "11cpUwQf8DpRaJbKpDwr8rBAQTmsVp72X4LePQokUM8SZWfaPSp"
},
{
"lng": -112.02337472794586,
"lat": 33.371050552126555,
"status": {
"online": "online",
"height": 488892
},
"score_update_height": 488877,
"score": 0.7867889404296875,
"owner": "13ZQv5D9xiAziFxYz5SffsZH3iTaKW7WH5LXeWvnq79usjwrwhN",
"nonce": 2,
"name": "old-opal-bison",
"location": "8c48e96934201ff",
"geocode": {
"short_street": "E South Mountain Ave",
"short_state": "AZ",
"short_country": "US",
"short_city": "Phoenix",
"long_street": "East South Mountain Avenue",
"long_state": "Arizona",
"long_country": "United States",
"long_city": "Phoenix",
"city_id": "cGhvZW5peGFyaXpvbmF1bml0ZWQgc3RhdGVz"
},
"block_added": 102779,
"block": 488901,
"address": "112ucXwiiR6i6zgkEbfUHpFtggivB4qKx8EMjAG7ZSJmhTrRwTA1"
},
{
"lng": -79.88736058394272,
"lat": 40.398811120042815,
"status": {
"online": "online",
"height": 488864
},
"score_update_height": 488893,
"score": 0.8791351318359375,
"owner": "14FUSqWYcWfQd7KQjrDSPXehsxvtJqxFf2q2QdxakbH4597KCz9",
"nonce": 1,
"name": "custom-khaki-bat",
"location": "8c2a8472a5287ff",
"geocode": {
"short_street": "Grant Ave",
"short_state": "PA",
"short_country": "US",
"short_city": "Homestead",
"long_street": "Grant Avenue",
"long_state": "Pennsylvania",
"long_country": "United States",
"long_city": "Homestead",
"city_id": "aG9tZXN0ZWFkcGVubnN5bHZhbmlhdW5pdGVkIHN0YXRlcw"
},
"block_added": 161205,
"block": 488901,
"address": "11rraissynzdXzuvR9C9zsiPuZCMsJ33jMszpNqafKhCN8T1LtJ"
},
{
"lng": -104.9819667654663,
"lat": 39.731924587349546,
"status": {
"online": "online",
"height": 488887
},
"score_update_height": 488873,
"score": 0.681549072265625,
"owner": "14mgCFAcGKtcu3L3ZFrqFNvcozeWFCNRvqWtwBvifa1R6EqmiaJ",
"nonce": 4,
"name": "shaggy-pistachio-rabbit",
"location": "8c268cda821b9ff",
"geocode": {
"short_street": "Logan St",
"short_state": "CO",
"short_country": "US",
"short_city": "Denver",
"long_street": "Logan Street",
"long_state": "Colorado",
"long_country": "United States",
"long_city": "Denver",
"city_id": "ZGVudmVyY29sb3JhZG91bml0ZWQgc3RhdGVz"
},
"block_added": 126278,
"block": 488901,
"address": "11pbDpPD8xGQxzJYcEgUTjB2A299bZqd5MyP3CUiEqYLdiDe4CX"
},
{
"lng": -118.43240806178659,
"lat": 34.06300352288759,
"status": {
"online": "online",
"height": 488881
},
"score_update_height": 488816,
"score": 0.7606201171875,
"owner": "14WKFHYag7LGCFgPBWQUHiM2Pvtie1fiykDSUGUecKQMwPgMNuA",
"nonce": 1,
"name": "jumpy-pear-toad",
"location": "8c29a199d4639ff",
"geocode": {
"short_street": "Wilshire Blvd",
"short_state": "CA",
"short_country": "US",
"short_city": "Los Angeles",
"long_street": "Wilshire Boulevard",
"long_state": "California",
"long_country": "United States",
"long_city": "Los Angeles",
"city_id": "bG9zIGFuZ2VsZXNjYWxpZm9ybmlhdW5pdGVkIHN0YXRlcw"
},
"block_added": 465022,
"block": 488901,
"address": "11DDaP3k7aZFKr1C8B9gdyvChX79RHvGbydzRxwEVHEBFd3NdKK"
},
{
"lng": -87.90081429668973,
"lat": 42.126905592654815,
"status": {
"online": "online",
"height": 488887
},
"score_update_height": 488879,
"score": 0.9979248046875,
"owner": "14EQRNNEmjK8bM97NEp5vM441u7mcTxrPjnVJ4dJ8SD2X9Qwseb",
"nonce": 5,
"name": "brilliant-teal-lemur",
"location": "8c2759adc50bdff",
"geocode": {
"short_street": "Mill Cir",
"short_state": "IL",
"short_country": "US",
"short_city": "Wheeling",
"long_street": "Mill Circle",
"long_state": "Illinois",
"long_country": "United States",
"long_city": "Wheeling",
"city_id": "d2hlZWxpbmdpbGxpbm9pc3VuaXRlZCBzdGF0ZXM"
},
"block_added": 117340,
"block": 488901,
"address": "11UtixMtxVK73SrdDqXGTRsmJNfgiHipXUHmeF6Tjp4HETnSooz"
},
{
"lng": -80.18078079776579,
"lat": 26.022409638823497,
"status": {
"online": "online",
"height": 488881
},
"score_update_height": 488858,
"score": 0.9946136474609375,
"owner": "14FvBfvRkERkW4RrR16i5NharQh8Ehjq77RowbpWbdxUiHAXUdi",
"nonce": 1,
"name": "zesty-peanut-nightingale",
"location": "8c44a10426003ff",
"geocode": {
"short_street": "Cleveland St",
"short_state": "FL",
"short_country": "US",
"short_city": "Hollywood",
"long_street": "Cleveland Street",
"long_state": "Florida",
"long_country": "United States",
"long_city": "Hollywood",
"city_id": "aG9sbHl3b29kZmxvcmlkYXVuaXRlZCBzdGF0ZXM"
},
"block_added": 452874,
"block": 488901,
"address": "11VSRV6KZjdhBqabde1Piq4zkRVa1WRNEFAW22XMBfGtAHW7nV9"
},
{
"lng": -121.97991888865624,
"lat": 37.31889190483364,
"status": {
"online": "online",
"height": 488862
},
"score_update_height": 488845,
"score": 0.9733428955078125,
"owner": "14NHk7ajkBnsBsSfZSmmHRD5SHb1UvWyLdwz5z9MCEDyjezFWXD",
"nonce": 1,
"name": "rapid-spruce-opossum",
"location": "8c28347048cd1ff",
"geocode": {
"short_street": "Norwalk Dr",
"short_state": "CA",
"short_country": "US",
"short_city": "San Jose",
"long_street": "Norwalk Drive",
"long_state": "California",
"long_country": "United States",
"long_city": "San Jose",
"city_id": "c2FuIGpvc2VjYWxpZm9ybmlhdW5pdGVkIHN0YXRlcw"
},
"block_added": 147758,
"block": 488901,
"address": "112uRR5Vhz1kBW6c2Jbn4wDcokKibUi3NSjLwDGnBBHFuwNYuidN"
},
{
"lng": -74.91795266574553,
"lat": 39.04734411775066,
"status": {
"online": "online",
"height": 488888
},
"score_update_height": 488850,
"score": 0.9910125732421875,
"owner": "13oBvk7EmZ5nMckycXRoBrR7ymXeFWn86gFhso14QnJWmB8HJQG",
"nonce": 3,
"name": "acidic-banana-pangolin",
"location": "8c2aad1441095ff",
"geocode": {
"short_street": "N 12th St",
"short_state": "NJ",
"short_country": "US",
"short_city": "Villas",
"long_street": "North 12th Street",
"long_state": "New Jersey",
"long_country": "United States",
"long_city": "Villas",
"city_id": "dmlsbGFzbmV3IGplcnNleXVuaXRlZCBzdGF0ZXM"
},
"block_added": 448442,
"block": 488901,
"address": "11xF1ZrLGDtS1VrLU7zCwzMBu3UCHrLTzPvvT63qkcDvSnLgzYy"
},
{
"lng": -118.3147080907313,
"lat": 34.024854598484325,
"status": {
"online": "online",
"height": 488892
},
"score_update_height": 488863,
"score": 0.9638671875,
"owner": "146j8VSV8gydkDVmUMeBbzwM5t879uzK5xop9Gx1Hs4pEACEszp",
"nonce": 4,
"name": "crazy-cedar-swift",
"location": "8c29a1d65c687ff",
"geocode": {
"short_street": "W 35th St",
"short_state": "CA",
"short_country": "US",
"short_city": "Los Angeles",
"long_street": "West 35th Street",
"long_state": "California",
"long_country": "United States",
"long_city": "Los Angeles",
"city_id": "bG9zIGFuZ2VsZXNjYWxpZm9ybmlhdW5pdGVkIHN0YXRlcw"
},
"block_added": 338998,
"block": 488901,
"address": "112UBBKntnNF6LeqDTVfNmay9X3CKQSVW5iaSiFqFVfWpjCP3VKF"
},
{
"lng": -122.42776937373586,
"lat": 37.66143533833919,
"status": {
"online": "online",
"height": 488891
},
"score_update_height": 488803,
"score": 0.985321044921875,
"owner": "14HvA6X2uKjSwsihJPnHHx2P4E1rbCTjSJuWkKAZzNpeUmfeRR2",
"nonce": 1,
"name": "rich-oily-whale",
"location": "8c2830972d329ff",
"geocode": {
"short_street": "Treeside Ct",
"short_state": "CA",
"short_country": "US",
"short_city": "South San Francisco",
"long_street": "Treeside Court",
"long_state": "California",
"long_country": "United States",
"long_city": "South San Francisco",
"city_id": "c291dGggc2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz"
},
"block_added": 147503,
"block": 488901,
"address": "11oygj4b5zEagbSTP3ozTcYfBCHJwLX9uQKeUtS65howdQyteGJ"
},
{
"lng": -75.27826551964438,
"lat": 40.08090500714629,
"status": {
"online": "online",
"height": 488816
},
"score_update_height": 488885,
"score": 0.991241455078125,
"owner": "13oBvk7EmZ5nMckycXRoBrR7ymXeFWn86gFhso14QnJWmB8HJQG",
"nonce": 4,
"name": "noisy-coal-beaver",
"location": "8c2aac9492d51ff",
"geocode": {
"short_street": "State Rte 3014",
"short_state": "PA",
"short_country": "US",
"short_city": "Lafayette Hill",
"long_street": "State Route 3014",
"long_state": "Pennsylvania",
"long_country": "United States",
"long_city": "Lafayette Hill",
"city_id": "bGFmYXlldHRlIGhpbGxwZW5uc3lsdmFuaWF1bml0ZWQgc3RhdGVz"
},
"block_added": 448854,
"block": 488901,
"address": "11judjQVWMVBmsvBaQrtBZE831wVBo7LLdU4RKU1J7aVEqvztrx"
},
{
"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
GET https://api.helium.io/v1/hotspots/:address/challenges
Lists the challenge (receipts) that the given hotspot was a challenger, challengee or witness in.
This route is paged using a cursor.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (optional) | string | B58 address of the hotspot to look up |
Query Parameters
| param | Type | Note |
|---|---|---|
| cursor (optional) | string | Cursor for the page to fetch |
| min_time (optional) | string | First time to include data for |
| max_time (optional) | string | Last time to include data for |
| limit (optional) | number | Maximum number of items to return |
200: OK
Fetches the challenges that the hotspot with 11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ
was involved in.
{
"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": 1593710795456164133,
"signal": -77,
"packet_hash": "5AN5Y3hcAVqZk_9KFetSbh-Z_qPGSeN-MFcH7neSyNM",
"owner": "14cSUPEX76FLdhjgyT6Y6fBFYzeJdTjTMDDrHDnpeA8tSXmYrfq",
"location": "8c2ab60c46e4bff",
"gateway": "1112cKvndYQE1X3BxpRtuycvh36ehEuA4yqpiSzJqMGzrcQGUER"
},
{
"timestamp": 1593710795454238307,
"signal": -94,
"packet_hash": "5AN5Y3hcAVqZk_9KFetSbh-Z_qPGSeN-MFcH7neSyNM",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c170b9ff",
"gateway": "112LxPghCf7qXigCBRz74LTAKKvPtfYPjqPxbBpkie9E9BcrMDdc"
},
{
"timestamp": 1593710795459449071,
"signal": -71,
"packet_hash": "5AN5Y3hcAVqZk_9KFetSbh-Z_qPGSeN-MFcH7neSyNM",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c4b46dff",
"gateway": "11iYaU281c2Yjo2tvMxyeu1t95Cv7aLWuAoBYte51gZ7bKijzpj"
},
{
"timestamp": 1593710795447538617,
"signal": -78,
"packet_hash": "5AN5Y3hcAVqZk_9KFetSbh-Z_qPGSeN-MFcH7neSyNM",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c426e7ff",
"gateway": "1128s66jgeG9oxw33FV7Gw52wfNukPSKGupB2C7N3w1poid5LeRC"
}
],
"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"
},
{
"timestamp": 1593710797325570974,
"signal": -99,
"packet_hash": "viJWqE5v96u8eKCRwTqm-bf2IlD2m87N3A0SKs7Yf4c",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c426e7ff",
"gateway": "1128s66jgeG9oxw33FV7Gw52wfNukPSKGupB2C7N3w1poid5LeRC"
},
{
"timestamp": 1593710797326235913,
"signal": -81,
"packet_hash": "viJWqE5v96u8eKCRwTqm-bf2IlD2m87N3A0SKs7Yf4c",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60e3c14bff",
"gateway": "11a44i7ry5WQ2ZuPTL5Hpx7RkQBHevNwiQkpU6sZgGxkYQ9K59o"
}
],
"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": 1593708823089884139,
"signal": -91,
"packet_hash": "bAxUoDw2Ypgv1qY6ZzFZBYun99Fa_ch4VPqKhdBZJD8",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c389c5ff",
"gateway": "112rzgdhF48KqLKUUuJe6FKQX6yVaCte639JuuixtybHkezL2iAB"
},
{
"timestamp": 1593708823101331551,
"signal": -99,
"packet_hash": "bAxUoDw2Ypgv1qY6ZzFZBYun99Fa_ch4VPqKhdBZJD8",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c170b9ff",
"gateway": "112LxPghCf7qXigCBRz74LTAKKvPtfYPjqPxbBpkie9E9BcrMDdc"
},
{
"timestamp": 1593708823100783822,
"signal": -91,
"packet_hash": "bAxUoDw2Ypgv1qY6ZzFZBYun99Fa_ch4VPqKhdBZJD8",
"owner": "13gXUZcSK6RBAByDQmETVNgqXBQcSi7agTe1gN7mWevVJSY6qsp",
"location": "8c2ab60c58341ff",
"gateway": "112BgzGtWwcCsL98Xpcz6p5bJeaS1KrcevDeYnrZSKDzqgBngW1a"
},
{
"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
GET https://api.helium.io/v1/hotspots/:address/rewards
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.
The result will be a list of rewards between min_time and max_time both given in UTC. Both
default to "now" which means that at least one of the two parameters is required.
The result includes a type field which is the type of activity that generated the reward.
This route is paged using a cursor.
info
For older reward results, if the type is null the amount is a total for that hotspot in the
given block.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | string | B58 address of the hotspot |
Query Parameters
| param | Type | Note |
|---|---|---|
| cursor (optional) | string | Cursor for page of rewards to fetch |
| max_time (optional) | string | Last timestamp to include rewards for |
| min_time (required) | string | First timestamp to include rewards for |
200: OK
Rewards for a hotspot with time range: max_time=2020-08-29&min_time=2020-08-27
{
"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"
}
]
}
Rewards in a Rewards Block for a Hotspot
GET https://api.helium.io/v1/hotspots/:address/rewards/:block
Returns rewards for a given hotspot for a given block.
The result includes a type field which is the type of activity that generated the reward.
This route is paged using a cursor.
info
For older reward results, if the type is null the amount is a total for that hotspot in the
given block.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | string | B58 address of the hotspot |
200: OK
Rewards for a hotspot in block 470788
{
"data": [
{
"type": null,
"timestamp": "2020-08-28T01:29:46.000000Z",
"hash": "DTU1GGfR0eU15hv6KiV_bg6FOJXfUWz4TjIq1H7TGy4",
"gateway": "113kQU96zqePySTahB7PEde9ZpoWK76DYK1f57wyhjhXCBoAu88",
"block": 470788,
"amount": 7885016,
"account": "12xUoMKwf12ABjNx4VCvYcNkX79gW1kzz2JnBLxkFbjswRczRvM"
}
]
}
Reward Total for a Hotspot
GET https://api.helium.io/v1/hotspots/:address/rewards/sum
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.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | string | B58 address of the hotspot |
Query Parameters
| param | Type | Note |
|---|---|---|
| max_time (optional) | string | Last timestamp to include rewards for |
| min_time (required) | string | First timestamp to include rewards for |
| bucket (optional) | string | Get data in buckets ( hour / month / week ) |
200: OK
{
"data": {
"max_time": "2020-08-29T00:00:00Z",
"min_time": "2020-08-27T00:00:00Z",
"sum": "164942208"
}
}
Witnesses for a Hotspot
GET https://api.helium.io/v1/hotspots/:address/witnesses
Retrieves the list of witnesses for a given hotspot over about the last 5 days of blocks.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | string | B58 address for a hotspot to look up |
200: OK
{
"data": [
{
"lng": -84.38947964027781,
"lat": 33.77442909128778,
"timestamp_added": "2021-06-24T22:12:07.000000Z",
"status": {
"online": "online",
"listen_addrs": [
"/p2p/11PhkxBRa6SXjKTj32RdDhbU9jwPNvmL1rgPScfT8VwHJWTkmG6/p2p-circuit/p2p/112vrDrzMZjE8NkxgUuLWSrfXuQFA3fDhaNEca7FPmyEV4SwPJEk"
],
"height": 900645
},
"reward_scale": 1.0,
"owner": "14ZDTJZE41rQJPxrSHgp3UKuyZnB1KZuE3pZgMAhJraKfEF6X7D",
"nonce": 2,
"name": "merry-blood-otter",
"mode": "full",
"location_hex": "8844c1a8ebfffff",
"location": "8c44c1a8eadebff",
"last_poc_challenge": 900303,
"last_change_block": 900738,
"geocode": {
"short_street": "Spring St NW",
"short_state": "GA",
"short_country": "US",
"short_city": "Atlanta",
"long_street": "Spring Street Northwest",
"long_state": "Georgia",
"long_country": "United States",
"long_city": "Atlanta",
"city_id": "YXRsYW50YWdlb3JnaWF1bml0ZWQgc3RhdGVz"
},
"gain": 23,
"elevation": 50,
"block_added": 895576,
"block": 900768,
"address": "112vrDrzMZjE8NkxgUuLWSrfXuQFA3fDhaNEca7FPmyEV4SwPJEk"
},
{
"lng": -84.41078918647065,
"lat": 33.78627614557136,
"timestamp_added": "2021-06-22T15:33:09.000000Z",
"status": {
"online": "online",
"listen_addrs": [
"/p2p/113hRKavKYh8oRg1qTPWyB9a24tVrSRLP67jUbRutm2AcHC4bAj/p2p-circuit/p2p/11BXSMm2PnVEnRUvKhjfoF3bQS1r45x8SynmXkBpR2uW18LDfeG"
],
"height": 900645
},
"reward_scale": 1.0,
"owner": "13CsDkkHCroh7EFKjEkT74JmC7qkr4PuJn4jybqShBzYYrR4p7B",
"nonce": 1,
"name": "fun-hazel-gorilla",
"mode": "full",
"location_hex": "8844c1a88bfffff",
"location": "8c44c1a88a2c9ff",
"last_poc_challenge": 900738,
"last_change_block": 900763,
"geocode": {
"short_street": "14th St NW",
"short_state": "GA",
"short_country": "US",
"short_city": "Atlanta",
"long_street": "14th Street Northwest",
"long_state": "Georgia",
"long_country": "United States",
"long_city": "Atlanta",
"city_id": "YXRsYW50YWdlb3JnaWF1bml0ZWQgc3RhdGVz"
},
"gain": 12,
"elevation": 0,
"block_added": 892710,
"block": 900768,
"address": "11BXSMm2PnVEnRUvKhjfoF3bQS1r45x8SynmXkBpR2uW18LDfeG"
}
]
}
Witnessed for a Hotspot
GET https://api.helium.io/v1/hotspots/:address/witnessed
Retrieves the list of hotspots the given hotspot witnessed over the last 5 days.
- Request
- Response
Path Parameters
| param | Type | Note |
|---|---|---|
| address (required) | string | B58 address for a hotspot to look up |
Shows the hotspots that hotspot 11sYnfeGAbFzDhXJ9NujYY2v2CnrcXPrewiF4iRN8upMs3HYUN2 witnessed
200: OK
{
"data": [
{
"address": "112ZUpjfpGjCgoHjF5d2AUVznDYSFBzZcupdcZ5AivXkS2CNkKAG",
"block": 943086,
"block_added": 909051,
"elevation": 35,
"gain": 58,
"geocode": {
"city_id": "amFiYWwgbHVibmFubGViYW5vbg",
"long_city": null,
"long_country": "Lebanon",
"long_state": "Jabal Lubnan",
"long_street": "قماطية",
"short_city": null,
"short_country": "LB",
"short_state": "Jabal Lubnan",
"short_street": "قماطية"
},
"last_change_block": 943072,
"last_poc_challenge": 942763,
"lat": 33.79955623248546,
"lng": 35.58377688261546,
"location": "8c2da24de12c7ff",
"location_hex": "882da24de1fffff",
"mode": "full",
"name": "handsome-satin-bat",
"nonce": 1,
"owner": "13VKSpg4fW4EbroEAEe5H7JsWM5sUBAvcQHiJWgPx2ztci5HHFg",
"payer": "13ENbEQPAvytjLnqavnbSAzurhGoCSNkGECMx7eHHDAfEaDirdY",
"reward_scale": 1.0,
"status": {
"height": 942913,
"listen_addrs": ["/ip4/185.187.130.9/tcp/44158"],
"online": "online",
"timestamp": "2021-07-29T08:27:35.292000Z"
},
"timestamp_added": "2021-07-06T12:25:11.000000Z"
},
{
"address": "112KiUgwQjH3HWC8DRD1AwzBd6JYVQhcyTm2cuH9S52VAEufUTxx",
"block": 943086,
"block_added": 586187,
"elevation": 40,
"gain": 58,
"geocode": {
"city_id": "amFiYWwgbHVibmFubGViYW5vbg",
"long_city": null,
"long_country": "Lebanon",
"long_state": "Jabal Lubnan",
"long_street": "قماطية",
"short_city": null,
"short_country": "LB",
"short_state": "Jabal Lubnan",
"short_street": "قماطية"
},
"last_change_block": 943077,
"last_poc_challenge": 943053,
"lat": 33.80608713927618,
"lng": 35.573540070314635,
"location": "8c2da24d12c19ff",
"location_hex": "882da24d13fffff",
"mode": "full",
"name": "furry-mossy-spider",
"nonce": 5,
"owner": "14CTinSvsJJDfYmbVfNUscB8ZW1GWSDmCodK3SE2kCW9oAVpERU",
"payer": "14fzfjFcHpDR1rTH8BNPvSi5dKBbgxaDnmsVPbCjuq9ENjpZbxh",
"reward_scale": 0.8333282470703125,
"status": {
"height": 942453,
"listen_addrs": ["/ip4/185.187.130.21/tcp/44158"],
"online": "online",
"timestamp": "2021-07-29T01:09:21.481000Z"
},
"timestamp_added": "2020-11-12T17:15:45.000000Z"
}
]
}