Hotspots

List Hotspots

List known hotspots as registered on the blockchain.The results are paged. If a cursor field is present in the response, more results are available.

Query Parameters

Name

Tags

Description

Example

Type

optional

Cursor for page to fetch.

eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0

text

Response

{
  "data": [
    {
      "lng": -122.39186733984285,
      "lat": 37.784056617819544,
      "status": {
        "online": "offline",
        "height": 394065
      },
      "score_update_height": 395577,
      "score": 0.25,
      "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT",
      "nonce": 1,
      "name": "tall-plum-griffin",
      "location": "8c283082a1a19ff",
      "geocode": {
        "short_street": "Bryant St",
        "short_state": "CA",
        "short_country": "US",
        "short_city": "SF",
        "long_street": "Bryant Street",
        "long_state": "California",
        "long_country": "United States",
        "long_city": "San Francisco",
        "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz"
      },
      "block_added": 395575,
      "block": 397023,
      "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db"
    },
    {
      "lng": 5.5794356104890825,
      "lat": 45.13127467725158,
      "status": {
        "online": "online",
        "height": 391690
      },
      "score_update_height": 395502,
      "score": 0.25,
      "owner": "13wv9QctMFJqQpvbZq8GuwaKc7YxUuvMw6WQD5JouvB3L2kuGwT",
      "nonce": 1,
      "name": "keen-metal-halibut",
      "location": "8c1f933292185ff",
      "geocode": {
        "short_street": "Chemin de la Colline",
        "short_state": "Auvergne-Rhône-Alpes",
        "short_country": "FR",
        "short_city": "Lans-en-Vercors",
        "long_street": "Chemin de la Colline",
        "long_state": "Auvergne-Rhône-Alpes",
        "long_country": "France",
        "long_city": "Lans-en-Vercors",
        "city_id": "bGFucy1lbi12ZXJjb3JzYXV2ZXJnbmUtcmjDtG5lLWFscGVzZnJhbmNl"
      },
      "block_added": 395500,
      "block": 397023,
      "address": "1122FqmqcH5uk8J1BSAStYK436GAR9CuwDVuBT2gRduofm9Vh7Lq"
    },

    {
      "lng": -81.77662146961255,
      "lat": 24.55934059588725,
      "status": {
        "online": "online",
        "height": 396910
      },
      "score_update_height": 396984,
      "score": 0.2593841552734375,
      "owner": "131uuuyiYrPczy1aCKDBhvxYTG7ZMNfnZnKgemesd3CZEe3y6EU",
      "nonce": 2,
      "name": "nutty-daffodil-ferret",
      "location": "8c4416a324933ff",
      "geocode": {
        "short_street": "Seidenberg Ave",
        "short_state": "FL",
        "short_country": "US",
        "short_city": "Key West",
        "long_street": "Seidenberg Avenue",
        "long_state": "Florida",
        "long_country": "United States",
        "long_city": "Key West",
        "city_id": "a2V5IHdlc3RmbG9yaWRhdW5pdGVkIHN0YXRlcw"
      },
      "block_added": 377240,
      "block": 397023,
      "address": "117ucorijFWJ662HH1q6aYz78Y5q2FfF9DMyx4Ka73vBqsEuuMG"
    }
  ],
  "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"
}

Hotspot for Address

List known hotspots as registered on the blockchain.The results are paged. If a cursor field is present in the response, more results are available.

Path Parameters

Name

Tags

Description

Example

Type

required

Address of hotspot to fetch.

11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db

text

Response

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

Hotspot for Name

Fetch the hotspots which map to the given 3-word animal name. The name must be all lower-case with dashes between the words, e.g. tall-plum-griffin. Because of collisions in the Angry Purple Tiger algorithm, the given name might map to more than one hotspot.

Path Parameters

Name

Tags

Description

Example

Type

required

Name of hotspot(s) to fetch.

tall-plum-griffin

text

Response

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

Hotspot Location Distance Search

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

Query Parameters

Name

Tags

Description

Example

Type

required

Latitude of the location to search around.

37.784056617819544

float

required

Longitude of the location to search around.

-122.39186733984285

float

required

Distance (in meters) from location to search within.

200

number

optional

Cursor for page to fetch.

eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0

text

Response

{
  "data": [
    {
      "lng": -122.39186733984285,
      "lat": 37.784056617819544,
      "status": {
        "online": "offline",
        "height": 394065
      },
      "score_update_height": 395577,
      "score": 0.25,
      "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT",
      "nonce": 1,
      "name": "tall-plum-griffin",
      "location": "8c283082a1a19ff",
      "geocode": {
        "short_street": "Bryant St",
        "short_state": "CA",
        "short_country": "US",
        "short_city": "SF",
        "long_street": "Bryant Street",
        "long_state": "California",
        "long_country": "United States",
        "long_city": "San Francisco",
        "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz"
      },
      "block_added": 395575,
      "block": 397023,
      "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db"
    },
    {
      "lng": 5.5794356104890825,
      "lat": 45.13127467725158,
      "status": {
        "online": "online",
        "height": 391690
      },
      "score_update_height": 395502,
      "score": 0.25,
      "owner": "13wv9QctMFJqQpvbZq8GuwaKc7YxUuvMw6WQD5JouvB3L2kuGwT",
      "nonce": 1,
      "name": "keen-metal-halibut",
      "location": "8c1f933292185ff",
      "geocode": {
        "short_street": "Chemin de la Colline",
        "short_state": "Auvergne-Rhône-Alpes",
        "short_country": "FR",
        "short_city": "Lans-en-Vercors",
        "long_street": "Chemin de la Colline",
        "long_state": "Auvergne-Rhône-Alpes",
        "long_country": "France",
        "long_city": "Lans-en-Vercors",
        "city_id": "bGFucy1lbi12ZXJjb3JzYXV2ZXJnbmUtcmjDtG5lLWFscGVzZnJhbmNl"
      },
      "block_added": 395500,
      "block": 397023,
      "address": "1122FqmqcH5uk8J1BSAStYK436GAR9CuwDVuBT2gRduofm9Vh7Lq"
    },

    {
      "lng": -81.77662146961255,
      "lat": 24.55934059588725,
      "status": {
        "online": "online",
        "height": 396910
      },
      "score_update_height": 396984,
      "score": 0.2593841552734375,
      "owner": "131uuuyiYrPczy1aCKDBhvxYTG7ZMNfnZnKgemesd3CZEe3y6EU",
      "nonce": 2,
      "name": "nutty-daffodil-ferret",
      "location": "8c4416a324933ff",
      "geocode": {
        "short_street": "Seidenberg Ave",
        "short_state": "FL",
        "short_country": "US",
        "short_city": "Key West",
        "long_street": "Seidenberg Avenue",
        "long_state": "Florida",
        "long_country": "United States",
        "long_city": "Key West",
        "city_id": "a2V5IHdlc3RmbG9yaWRhdW5pdGVkIHN0YXRlcw"
      },
      "block_added": 377240,
      "block": 397023,
      "address": "117ucorijFWJ662HH1q6aYz78Y5q2FfF9DMyx4Ka73vBqsEuuMG"
    }
  ],
  "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"
}

Hotspot Location Box Search

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

Query Parameters

Name

Tags

Description

Example

Type

required

Latitude of the south-west corner.

38.0795392

float

required

Longitude of the south-west corner.

-122.5671627

float

required

Latitude of the north-east corner.

38.1588012

float

required

Longitude of the north-east corner.

-122.5046937

float

optional

Cursor for page to fetch.

eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0

text

Response

{
  "data": [
    {
      "lng": -122.39186733984285,
      "lat": 37.784056617819544,
      "status": {
        "online": "offline",
        "height": 394065
      },
      "score_update_height": 395577,
      "score": 0.25,
      "owner": "14e35CChhsnuHJxjjzYAxsHKBKDgjUop4GuD8esB7gE2VDoyPXT",
      "nonce": 1,
      "name": "tall-plum-griffin",
      "location": "8c283082a1a19ff",
      "geocode": {
        "short_street": "Bryant St",
        "short_state": "CA",
        "short_country": "US",
        "short_city": "SF",
        "long_street": "Bryant Street",
        "long_state": "California",
        "long_country": "United States",
        "long_city": "San Francisco",
        "city_id": "c2FuIGZyYW5jaXNjb2NhbGlmb3JuaWF1bml0ZWQgc3RhdGVz"
      },
      "block_added": 395575,
      "block": 397023,
      "address": "11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db"
    },
    {
      "lng": 5.5794356104890825,
      "lat": 45.13127467725158,
      "status": {
        "online": "online",
        "height": 391690
      },
      "score_update_height": 395502,
      "score": 0.25,
      "owner": "13wv9QctMFJqQpvbZq8GuwaKc7YxUuvMw6WQD5JouvB3L2kuGwT",
      "nonce": 1,
      "name": "keen-metal-halibut",
      "location": "8c1f933292185ff",
      "geocode": {
        "short_street": "Chemin de la Colline",
        "short_state": "Auvergne-Rhône-Alpes",
        "short_country": "FR",
        "short_city": "Lans-en-Vercors",
        "long_street": "Chemin de la Colline",
        "long_state": "Auvergne-Rhône-Alpes",
        "long_country": "France",
        "long_city": "Lans-en-Vercors",
        "city_id": "bGFucy1lbi12ZXJjb3JzYXV2ZXJnbmUtcmjDtG5lLWFscGVzZnJhbmNl"
      },
      "block_added": 395500,
      "block": 397023,
      "address": "1122FqmqcH5uk8J1BSAStYK436GAR9CuwDVuBT2gRduofm9Vh7Lq"
    },

    {
      "lng": -81.77662146961255,
      "lat": 24.55934059588725,
      "status": {
        "online": "online",
        "height": 396910
      },
      "score_update_height": 396984,
      "score": 0.2593841552734375,
      "owner": "131uuuyiYrPczy1aCKDBhvxYTG7ZMNfnZnKgemesd3CZEe3y6EU",
      "nonce": 2,
      "name": "nutty-daffodil-ferret",
      "location": "8c4416a324933ff",
      "geocode": {
        "short_street": "Seidenberg Ave",
        "short_state": "FL",
        "short_country": "US",
        "short_city": "Key West",
        "long_street": "Seidenberg Avenue",
        "long_state": "Florida",
        "long_country": "United States",
        "long_city": "Key West",
        "city_id": "a2V5IHdlc3RmbG9yaWRhdW5pdGVkIHN0YXRlcw"
      },
      "block_added": 377240,
      "block": 397023,
      "address": "117ucorijFWJ662HH1q6aYz78Y5q2FfF9DMyx4Ka73vBqsEuuMG"
    }
  ],
  "cursor": "eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0"
}

Hotspots for H3 Index

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

Path Parameters

Name

Tags

Description

Example

Type

required

The h3 index to fetch hotspots for.

882aa38c2bfffff

text

Response

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

Hotspot Activity

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

Path Parameters

Name

Tags

Description

Example

Type

required

B58 address of the hotspot.

11cxkqa2PjpJ9YgY9qK3Njn4uSFu6dyK9xV8XE4ahFSqN1YN2db

text

Query Parameters

Name

Tags

Description

Example

Type

optional

Cursor for page of results to fetch.

eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0

text

Response

{
  "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

Name

Tags

Description

Example

Type

required

Account B58 address to fetch activity counts for.

11yTLDH2QbVLyRnBykzdLLP2j2DoAzjSp3obNrnxhUXpVdaYCZF

text

Transaction Types

Append the version on the transaction type name, eg: payment_v1

  • add gateway - Add a new gateway to the Helium Network. For the purposes of transactions, a “gateway” is the term for a Helium-compliant Miner that is mining and providing coverage.

  • assert location - Assert a gateway’s location on the Helium Network. This happens after a gateway has been added via the add gateway transaction. Once asserted, this location is then used as part of Proof of Coverage challenges. A Miner’s location can be asserted more than once but each subsequent assertion will a) cost a fee and b) reset that Miner’s score to neutral (.15)

  • chain vars - Change a chain variable.

  • coinbase - Similar to the bitcoin blockchain’s coinbase transaction but used only during testnet phases of the Helium blockchain. The rewards transaction has taken its place.

  • coinbase data credits - Created the initial 10,000 Data Credits required to bring the first group of Miners online.

  • consensus group - Marks the election of a new consensus group, responsible for mining during the next epoch.

  • create hashed timelock - Creates a transaction that can only be redeemed by providing the correct pre-image to the hashlock within the specified timelock.

  • create proof of coverage request - Submitted by a Miner wishing to initiate a challenge.

  • data credits - Burn HNT for DCs at the current oracle price and deliver them to the target wallet address.

  • genesis gateway - Used to define the initial group of Miners that bootstrapped the blockchain.

  • multi-payment - Used to send $HNT from one wallet to multiple wallets.

  • OUI - Create a OUI for a new router on the Helium network. In the Helium blockchain, Miners forward packets to Routers that own them based on their OUI as stored in the blockchain.

  • payment - Used to send $HNT from one wallet to another.

  • proof of coverage receipts - The result of a POC submitted to the network upon completion.

  • redeem hashed timelock - Redeem the transaction created using the create hashed timelock transaction.

  • reward - A token payout for a specific event on the network such as submitting a valid proof of coverage request, participating in a consensus group, etc.

  • rewards - Bundles multiple reward transactions at the end of each epoch and distributes all $HNT produced in that block to wallets that have earned them.

  • routing - Update the routing information associated with an OUI.

  • security coinbase - Distribution of security tokens in the genesis block.

  • security exchange - The transfer of security tokens from one address to another.

  • state channel open - Opens a new state channel on a Helium Router

  • state channel close - Closes a specific state channel on a Helium Router

  • token burn exchange rate - Change the exchange rate for burning $HNT to DCs.

Query Parameters

Name

Tags

Description

Example

Type

optional

Comma separated list of transaction types.

rewards_v1 , payment_v1

array enum

Response

{
  "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

Name

Tags

Description

Example

Type

required

B58 address of the hotspot to look up.

11ztQpmCJbfPxv3RjsnvFTozbikpZ72dgmHTYwBQ2n2rABytnLE

text

Query Parameters

Name

Tags

Description

Example

Type

optional

Cursor for page of results to fetch.

eyJoZWlnaHQiOjM5NzAyMywiYmVmb3JlX2Jsb2NrIjozNzcyNDAsImJlZm9yZV9hZGRyZXNzIjoiMTE3dWNvcmlqRldKNjYySEgxcTZhWXo3OFk1cTJGZkY5RE15eDRLYTczdkJxc0V1dU1HIn0

text

Response

{
	"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

{
  "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

Name

Tags

Description

Example

Type

required

B58 address of the hotspot to look up.

11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ

text

Query Parameters

Name

Tags

Description

Example

Type

optional

Cursor for page of results to fetch.

eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwfQ

text

Response

{
  "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

Name

Tags

Description

Example

Type

required

B58 address of the hotspot to look up.

11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ

text

Query Parameters

Name

Tags

Description

Example

Type

optional

Cursor for page of results to fetch.

eyJ0eXBlcyI6InBvY19yZWNlaXB0c192MSIsImJsb2NrIjozOTcwMDAsImFuY2hvcl9ibG9jayI6Mzk3MDAwfQ

text

required

Last timestamp to include rewards for.

2020-08-27T00:00:00Z

ISO8601 timestamp or relative time

required

First timestamp to include rewards for.

-1 week

ISO8601 timestamp or relative time

Response

{
  "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

Name

Tags

Description

Example

Type

required

B58 address of the hotspot to look up.

11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ

text

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

Name

Tags

Description

Example

Type

required

First timestamp to include rewards for.

-1 week

ISO8601 timestamp or relative time

required

Last timestamp to include rewards for.

2020-08-27T00:00:00Z

ISO8601 timestamp or relative time

Response

{
  "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

Name

Tags

Description

Example

Type

required

B58 address of the hotspot to look up.

11DvZivbwHVRx4PbQwAd5w2DQEAcfSCRVzsW7gjRKQ86nCEJxHJ

text

Response

{
  "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
      }
    }
  ]
}

Last updated