Accounts
List Accounts
Retrieve basic stats for the blockchain such as total token supply, and average block and election times over a number of intervals.
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for page to fetch. Note: The cursor for accounts is valid for a limited time.
eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0
text
Response
{
"data": [
{
"sec_nonce": 0,
"sec_balance": 0,
"nonce": 2,
"dc_nonce": 0,
"dc_balance": 0,
"block": 435239,
"balance": 0,
"address": "13etjTqyGLK7WQh8pp9VJy5ejh5MXmwFee2eAi3TfAA5kS1jEJb"
},
{
"sec_nonce": 0,
"sec_balance": 0,
"nonce": 0,
"dc_nonce": 0,
"dc_balance": 0,
"block": 435239,
"balance": 179087000000,
"address": "14Xg1SqiJDsmM2YvchR4UacevcuxjfyrjdyNEpRMmfBU7vrZba9"
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}List Richest Accounts
Returns up to 100 of the accounts sorted by highest token balance.
Query Parameters
Name
Tags
Description
Example
Type
Response
{
"data": [
{
"address": "1398hLeHESZHE5jVtaLAV5fdg2vrUeZEs2B92t7TzeQTtugr8dL",
"balance": 616416488712965,
"block": 489719,
"dc_balance": 0,
"dc_nonce": 0,
"nonce": 3,
"sec_balance": 351543978600,
"sec_nonce": 0
},
{
"address": "14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S",
"balance": 292033864604925,
"block": 489719,
"dc_balance": 0,
"dc_nonce": 0,
"nonce": 0,
"sec_balance": 166398670100,
"sec_nonce": 0
}
]
}Account for Address
Retrieve a specific account record. The account details for a record include additional speculative nonces that indicate what the expected nonce for the account is for a specific balance. Any transactions affecting the given balance type should use an adjusted speculative nonce for that balance type.
Path Parameters
Response
{
"data": {
"address": "1122ZQigQfeeyfSmH2i4KM4XMQHouBqK4LsTp33ppP3W2Knqh8gY",
"balance": 0,
"block": 311833,
"dc_balance": 100000000000000,
"dc_nonce": 0,
"nonce": 0,
"sec_balance": 0,
"sec_nonce": 0,
"speculative_nonce": 0
}
}Hotspots for Account
Fetches hotspots owned by a given account address.The list of returned hotspots is paged. If a cursor field is present more results are available.
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
Response
{
"data": [
{
"lng": -81.70707772367822,
"lat": 41.480133219396784,
"status": {
"online": "online",
"height": 435166,
"gps": "good_fix"
},
"score_update_height": 435153,
"score": 0.9222412109375,
"owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx",
"nonce": 1,
"name": "sneaky-violet-penguin",
"location": "8c2ab38f19a43ff",
"geocode": {
"short_street": "W 32nd St",
"short_state": "OH",
"short_country": "US",
"short_city": "Cleveland",
"long_street": "West 32nd Street",
"long_state": "Ohio",
"long_country": "United States",
"long_city": "Cleveland",
"city_id": "Y2xldmVsYW5kb2hpb3VuaXRlZCBzdGF0ZXM"
},
"block_added": 96087,
"block": 435241,
"address": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB"
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}OUIs for Account
Fetches OUIs owned by a given account address.The list of returned OUIs is paged. If a cursor field is present more results are available.
https://docs.helium.com/use-the-network/buy-an-oui/
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
Response
{
"data": [
{
"subnets": [
{
"mask": 8388352,
"base": 0
}
],
"owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc",
"oui": 1,
"nonce": 0,
"block": 762440,
"addresses": [
"112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
]
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}Activity for Account
Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for the next page of activity to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
Response
{
"data": [
{
"type": "rewards_v1",
"time": 1608741833,
"start_epoch": 644049,
"rewards": [
{
"type": "poc_challengers",
"gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"amount": 8423208,
"account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
}
],
"height": 644084,
"hash": "6A_8hid6ZIiyg32dzQwFajM-iDyAvYJdVccSpxyymi8",
"end_epoch": 644083
},
{
"type": "rewards_v1",
"time": 1608691560,
"start_epoch": 643255,
"rewards": [
{
"type": "poc_challengers",
"gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"amount": 8639175,
"account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
}
],
"height": 643353,
"hash": "jd5mq1OMG1q7g_JNJr5gFHD17uMSawvFNt8ARty2OGQ",
"end_epoch": 643352
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}Activity Counts for Account
Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
Count transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
The results are a map keyed by the given filter_types and the count of transaction of that type.
Path Parameters
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. Therewardstransaction 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 Routerstate channel close- Closes a specific state channel on a Helium Routertoken burn exchange rate- Change the exchange rate for burning $HNT to DCs.
Query Parameters
Name
Tags
Description
Example
Type
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
}
}Elections for Account
Fetches elections that hotspots for the given account are elected in.
https://docs.helium.com/blockchain/consensus-protocol/
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for the next page of elections to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
Response
{
"data": [
{
"type": "consensus_group_v1",
"time": 1608276577,
"proof": "g1AAAAdHeJxF1Hs403scB3BWZIdDuQxzadTRcctPSO5iLqedI3ILMwxDmEs4p6whSTEqyrbsnCNMSCObueS2Vi6VS3I8Cp1OF2zusllhzvpj_PX95_08r8_n_TzfT5yEhMT-aFC86NGRwI9ayb7Ga3lcJh9L0qTkHXXTzr0HL1YSTO5lofGR6DvfU26AC0hHgrZ968eJF4KzjfhZcqHsq9FQiDbfIAwZfzWO-s_GSyQPBAvu9PkmlT5U4SBpziI1YK9EZZNrZzy-DTu5_5CJOQs3E5urJbDq5UVW1ifX0s4CqeduzYBzvw3lRhcgs6cOnA_gxCbMc9tU8TBXcWLDXmi0gL6kKDtqbvXA-ogHm5asq4k7ZCCaql21vQnp98hV_8_Fr4duN7XFpZgBi3gpKWX-pUDV95mqYjPOIv55Q-o2CpY6NtDeL2ArzIQQaertsFGjA8cslzmGO2YGvmH-Yf7fI3OWl4suvAxyOf22kK5tdOpnrvq1WdL21UqRWVJYZsJcCKoO13N6qon3DfCOfbJWHBYRN4TunpmQnbQUm8waaIO97appqLcX-yr2K7-LPTemCkvKq3ceP7RWA_HbMR3tsEfzvSN1CcoXx7D7KsMfMytU9yAXN7jFjqiCntu2IvNNzrevvJCbuNx2_mjSIjViwd_n2eCyCfCOmOAyBa2-JDYJnh82U4tyAGx2R4ulpFvX6B-NMYbtcGiJ0mO4xrs3WzumkkabPiGELzE-ciI7mQzgpnv-m1kCy1sfTy5A2ASXhYrMvhwBPD37Sm-JxMHgoG71dORWfxPeawaTP6z7PsDmk5rY_IHoKL1pO55BYGk_dpf1Znkaadw2-2Mf0boporKsu1ZuxzQn7g2P-sIFC-IpaPDWPR9gJKXup6gqoWkgO2jmRO-GyCQNIkiOLTJqbbJawFxa8786Foot8heF0bqLf8OJkQeWxKbRBy6mQiNxHFcw88C-3Z-gAyWjDRhJMdG8giTcEtPhe8oVgINgGrg6qI1ePUHtnLK3D73xLcbjdzdml9C42EKh1nPl1HkQzLq17jM_uvXHSsMi1uz8sTuJZueuSWZJywG_XWCWGyg6icktzBKcONINuS1EaBK-GDZ4rTdP3al25FmT2F-mafJV31PugKtoiQ0TOFcbFd6pwZGbBrPNnF9PMko-eCebTrk4dfZK6N343u21EU7xOPXVMCjjs9qiuhmwdn3vSUTfxK2zMiCi3QpEjP5Ll8su_GkPZfDyJatwq9cJtCs1KgxlSPkhJU4Um1cSstPtea3fwPgulyjrDNMIVULwfbPkWd7NM84G695IQWl3spbIpKZUXbCf3bfFA1B3H4LnSa2-vneHQy1cqz9rK1uknbMQm95BYPq9FOwZ0MJH81dHL5yW-vi0z9lKf8XPv8PDONtauHsTBnKGgAKbesgpbaU3jV9ttc80evnbOHZa6dLT4mgn3kJBMB_odf0y30wHGgB1LT2-UF-rz94_tOWe7m4WIwUJ9xGITVAgarxJYRpMVoupGS4mDef1DGRhOlKsuI9PnbZ-RNLaLXcKNdFzFHqP4WGy2heByqzm2hsvVdk9H2SsliLuXzzsLIpURQfWD0qvZabH5BXue3knB3er9KIm8_ikwn7I3LpJkbsY9eosDPVrApJ0wmdM0yq3InI9s5ZWY8OWqyzdYpB-NMEumptHf9hYGpXLw2EKKzL3q6j4zyrYTFelum79XmyXVnNCFLmV7vICT92kv6KUy9ycH7FTiaNFFjVIEEKiZt87vCiPFaMK_LmR1z4wAZ91TV2BQ1N6hm0ZW_aV1EL14Jrjbbs4u-0O24UGxGxWAj8fDGzSIHZQOj7KM39t7ZmrMJdjLVAYiSBYEg08GvqA8d86echrm9e_csw4sQeOQK_HCGqFe36R44jNywNZ_Hya3wirsvhu95DlmCHHJEt5NjJiOwHNTHiqwdv5LTIqG2VCLQopt41atJWKNMEi2uyff-gNroh_NJlYiMCCYAeaVB16GHW6BlRtB5sznF6VAMkKsnxTUlg1yog-bf5UTPp-mouFdgSYdrBHMQwNIoFYN57qLx0Ad9p8EtHP15_bXZOkgz_4jnukL-PPK-9B59dw6w4v_agIP4uPnU4HWzB5BSAYzLWMyA0bpkc3Q8DKSa3LA88SKjawieRVXBzaOkx6XmwiNxv0INkrD4nBb2DMFgKtumWZ-m5R7y9MWn6vXMeA-u7xO2wh74gLkgbL4KjIX5PpTHQ6AvRWQe1RF_j8-I2VRNFUtUPsctTggyP3p4ztVQWHIREnO-ueFMVSLC0Hrpd_wgjP_Q_ffiin",
"members": [
"112qqYc77fYcGLYrD5Bd1zG1dwoXGCzaQ63oby8ws9mhDrhieTRv",
"11hxEKmhr2xgVu8srSdkmoQYNVYYKppKd82mtanBbU5kd9r42hs",
"11LmZdUgSn5Pwa8a2Q16EUDfyLutpDeQoUgzgerHJc73p8NTC3V",
"112374TV64PVuBDDArCymuiqA6AQdNr3q9JVthoYo5r9kBCS6N3",
"1124oBcVaT6pubZWxuPisQs8hNKaYp9cduvQ9skcpRmt14LnhsnX",
"11eq43bdC6iAsQJtSsxbEwZZP9ECZX7QYnWXn95uc3Ajym9bdP6",
"112vbpLrhj8kQdBn8FDBYR2KcXVh95HmPfgyZfuA8kL5kRKVEWyc",
"112hX6sPHCgYXP98tdac5TqPNfU17t3K8ZwdpLd1UfFSD8Xoqv3H",
"115fXeCtfk9FjpoNXn8QCikp1GVGgGg2S5BXq8RJovcDvFrXrL8",
"11xrgEdiN9DA2cyauB29AXDy8WoMEwhqaL1chU83YWGx7q81sp8",
"11d13u5TospVvAD8pGCYNZR3GrEykB4osswni5fcXnonfHDSEpG",
"11diD2YbFNJ4yHDoWZpJErdJmwRsGEepCteEHfFMwakrTxjvMRG",
"112PSpVub6tJxekGMF4N3wp7Yb883pPWiF4WCw9BeuugXJucGZqB",
"11pf3gLhyFPRCedRPngEUu3Rr25sRYi16WRRS1ZYsA6hGMpkaXU",
"11zcBW5mQx2iJbNUg3MhvUEVbnB7Ty4dFL7Pgt2qvENZiNSotuV",
"1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB"
],
"height": 637456,
"hash": "mKX9qDdsbbHfkllXZJPmDnaWftsHeFxodSfyTPTSPMA",
"delay": 5
},
{
"type": "consensus_group_v1",
"time": 1607829748,
"proof": "g1AAAAdAeJxF0nk81IkbB_DxDZspsTFj5PqOa8XkmoZhLIZhpNySKzYy5Mo1SGKw5MiZIwxlI-YnJqac5UghlN-Oe2VD_LDGEZqc-emPmf3r-efzer1fn-d5_CEQiLAPEHA0kBAh9jJzyB7cZncmiwst1Yq8DWwaXb_MI-XWHd0YoNe-9CNlqk4AQAOqgbh50QFmI5Kp_3VTCXFyOOmbrs0pmt1tefcoKm82AGKiy_3Lr8_bmZ1krVea5ZI8WG6f0ZpN45I5zGCJM7pwDqmCLqpGZDWDY51dzX9IxooIRVS-C7vl-vfIaFR6-zQ55kfKTN0UQEIWYmPn2HE_X9VlwqvHpyEU0TXGUzquVAvVYf3wsmWW31GkTPDM-mQwYz1q-3mXyUcPwsxcNK3G4r4w_p-B3F0h4zgOylgDzjfx8wvwLkbYlyB08Gnza5jJtRcDend7JyMe1m5xe2ram_Hgf_uwTVGr6VNyoWwKUij-D0zmbXpZ6jTcBVseAAzB3kg77eq_FzD_UhtDlihEiRqv89992AwPn8A7a9MdOGRzptCrxy91zFRp29WOSS9Las9lftTPXbXqPrco75cKq-OS0Fq4Uv59Z3mPnZTcleE0JHaAkLqbLmqNeGCbiVwtqAfAIHP9Te1Cvs-GKLV7MpJTlinzLFtrTcQMIuep4EkXArflAY7xrTFD5aGyBk9JlKT7PjEbfrgTautxwSWF7bTr2PMjRVQ3AUBDimV_3tn2WGxseW7VqgI8attd-8NysMvX8GLUtY3WhaPN1hLn0svarhokH0KGxiPZPzVgze0QEdCE4gUFmUQfnSKOKVf8Aj2AluEF0oYvYuXqQkdLKqETig0nnj_plJjwCV7imp4dQS4336igMhRUvl32tz-t3Nq6WZ-b73BtJ8rO0YqVf2SuTGNJyAPlDvtH_SfNvd5q1PMcOPJn3RpBa-ChqQreORxzh68zaOubbyGx73a6qN5u_pdPnR-Dyn0TparvMFBKsBzuaiXv8H2JjOha45-JzhIND6wzPz6ncvP5TT_cMgEu_tgNB4AK_ego2nSIsDDrU7j3Y9jGg_Phw8GvWj7oxruZeSrqm3NIAatLoVcrGKWk-KfP5a3yvKpijdoyQv35W5LDyjv4q_r__dqhzrkPTnVSytmWj1U-7wyZylu80Y2GkmLRjNmumRMEp6PIX8fIzdTj5Jmhcniiwb2oQPk_arZaPIstsHVO0HwV3rMc9CI58qpmSLUNRqnooEjv2UQTkneS7iXo6vyxV9dgPIDK7WmUerPmN9n3S-6xZ1jltnp0_lnZhEv7pe6D0LYeq0IbBwB0qd1CXBr8UnvhzQhhr1Slqo_pYrkHTaMJ-GhbtOvIZ3DIXwgNi9R7OOFJI5K4qOkTdcuznSsLX8BG_aS0FTjLNPDfno1jsnNxIh3f8-OW70rTM3suHuxXaOiHGOQJtRh6JZitH0V69bYrYnpo0rqNWXggSBslTdQ8rQCaZFfGA7t4i20ZDvrsUHWYHWm4kT_rqfqoi1iHO7Vh_bt48s8IvqATbPGV69wfso1eIkt00MeV1fbwKdRmI50_8Q0nNmNkzTKqxLI6Mm2PzLGY0VZ0PZg9cAPULAElRu6IGOeEA3KwGUNrY7_DUirHFJMuel9RSjVnrGOKM5PsVh2anXa8eeuQRp5kknmF7VOOiYTMZq1mrLSL5cV3hyWUFuQZYlIUFwcnZn-KN73xH74h6SoAlLq898Ak5J8GxRZFy8lTG2nvy3K0pJT1AsoiBYZTjftCOKZSmZ8yOgV-ilgRoa2Gp4XtetiEHgvW0j004UMGer7Dcu95B0lyGlAM1rxPQJPqnVFeJCOpqA7XwoQYXPct5lDzAACam_oCC8eu9ZdVv2AGFfye_exKmKVWxmgihrgtbDYFQ3FIG4B9vQx3zbbO74WqGnn_9WvcFciIxpi_tNUrbMrfrx9xSQ1_9dv0OSNHFZrlse2xiK24830JwRTK56mIwEGC4T4fABJXFb_nYNAW00liuZVNWahxjRqtd0bQHPFLfoycniuqHHL1vXhFsuMmHe_EU8D4n6RIcUlvYxvsL3kHCoM-iQA-cUk3I1bGlunaV797lD9fKX8iEKckL6Ql7MxGqvlA1iMFCwDw-JNO01vjNJu8aWavmOi5g5Bfy2Gw0NGhROwYKh1848khjxML5VqboXJTNd0YxjyZ3lutX9Lx_S2MzT58AktOGeCSUisTiyWPfsnM_69vFtXh12mDLQR1efCcjvWEzJhmG2oZAFHrGz6uMW9nyry_M1lht8E2byY_yeXQGaaTKitAdlHz_T_1TBOF",
"members": [
"11GgZk795fcucYYaCz6f3iXJpR8iA5FVBJFgYzFbdeciXVacrke",
"1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"11aEVjsaJN7gfjggGvFuGEgixQVRtkWzEpzX15YHiZJkLSsuwdv",
"112Lx9Tren485XT7PvY7GHnmUVMTvyjwZ6hrxL7ozeDvqE7Jy6pA",
"11L2XXdnBjVmJiyb86yLyhbkg75VYEjSx9D6qMKYdsS3mnJzXoS",
"11JtrTKA3wGNE2Fgep5HLC2B3YTRDsAt4vNc7GEsVp8Y7nYKGz1",
"11JJ4RR6oPbpVouU1rzkRQC9T4VavDZrbbPaes8FVoD33uyxHQV",
"11cgLFT851vXJT4iAno1G89kct7qVM4H17EYrbJmZBuJhAyuvgD",
"112vXW9jvfNKVzWGfMYZhEmBxbGVro5iNZmUWiermAXgRebac3Pa",
"112NFATPKh4y7dXudyM9NwFwxzoLYHbX5eFzMjbQtCXTnQJrL1Ze",
"11BBZMfB8c8L3V5YVQ8KSTsVF9gx5HFcDyB5c2S1E2g86w7UPdc",
"1156oi8swcmxmR4RGM7fGHFA2JP4Lk4UjXL11tcxZQGCqfh58Po",
"112tfwpKvCqwDfzsfyAnQwj7gbmx59zKCKDaxBsmCZ4pPBd8Gasv",
"112QirNzqW2LuGAuorXA68mr9qiuWnaEALFPkeBi5AK5S5gccRjS",
"112pArcjJA6mPKAFVifkK84YVkVUro5iWh2TSbTwBcV7xrsyQyQ2",
"114eVcYfr3ujqUGsEKs1pJQQGAJTA5Lf4JgG9BjVmKnodr41Q5q"
],
"height": 629706,
"hash": "c8gPYHwWpEGHMLhDynUHHw1k-qhW61JBPW8Q4kTlic0",
"delay": 5
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}Challenges for Account
Fetches challenges that hotspots owned by the given account are involved in as a challenger, challengee, or witness.
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for the next page of challenges to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
Response
{
"data": [
{
"type": "poc_receipts_v1",
"time": 1608740853,
"secret": "AEGM923859xCnALUTWtVzYIkRKXAL4E0Ss1JRchMhhMdBOhuXOob79UwlghHhEZN2ChZe7vvnltg8Z2D-adlb-kkL-hv_ONvpcsFXPw9y_LYzIwTS7TAIVbqKfuBn_IVRcc",
"request_block_hash": "JTUr-_hX--L6TuwIkx-DEzeB--yMheo2Ud-yZ4LNVt4",
"path": [
{
"witnesses": [
{
"timestamp": 1608740090285495600,
"snr": -9,
"signal": -100,
"packet_hash": "p2ZijVno8DHGJui_bV6u-tABHQOiEB_c3NCFOv_-1xE",
"owner": "146MwmL9eJJCdrykbgdL3dobdChP4Ut34mCZMR3Hv9HXTeBJQzC",
"location": "8c44a105ca1d3ff",
"is_valid": true,
"gateway": "11fJaz1xwA2Xh1gQQWRh6FzDabEPkLs5bSMdDnSrb4CL1L5Y5Su",
"frequency": 905.2999877929688,
"datarate": "SF9BW125",
"channel": 7
}
],
"receipt": {
"timestamp": 1608740088868575200,
"snr": 0,
"signal": 0,
"origin": "p2p",
"gateway": "112V5U5MSMVBDTe6cCzWEXzuCbjK96GbKXwDPFSCyjeVnL3wHk5L",
"frequency": 0,
"datarate": null,
"data": "5_w",
"channel": 0
},
"geocode": {
"short_street": "Leslie Dr",
"short_state": "FL",
"short_country": "US",
"short_city": "Hallandale Beach",
"long_street": "Leslie Drive",
"long_state": "Florida",
"long_country": "United States",
"long_city": "Hallandale Beach",
"city_id": "aGFsbGFuZGFsZSBiZWFjaGZsb3JpZGF1bml0ZWQgc3RhdGVz"
},
"challengee_owner": "1444k99dYKjngxQnqGxrB3CmqaFdGzPRWsxqbbu3LjjCyBocGhi",
"challengee_lon": -80.12177083059214,
"challengee_location": "8c44a10564825ff",
"challengee_lat": 25.9903614158387,
"challengee": "112V5U5MSMVBDTe6cCzWEXzuCbjK96GbKXwDPFSCyjeVnL3wHk5L"
}
],
"onion_key_hash": "I86cUPLZ46naXW6IFhhXGVFeKftMi4FhtpsJwtW03T8",
"height": 644070,
"hash": "Z5yrO_XbwTT89xFjA1_3OlSke1KmkJ7VZmigd7NDVk8",
"fee": 0,
"challenger_owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx",
"challenger_lon": -81.70707772367822,
"challenger_location": "8c2ab38f19a43ff",
"challenger_lat": 41.480133219396784,
"challenger": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB"
},
{
"type": "poc_receipts_v1",
"time": 1608739733,
"secret": "ABCXJG0PUoO0iyTzvmd-XPVfJdPW3HBztPWjld7TLvOtBA-1qOjN6UNWkVmPp69FkUrnqZmJr1Zz-H-4v1lu7HGaABQ0p3X_Ge4hNZ6b2SpijiqUYf7i9JjgxzwMUtvy8bg",
"request_block_hash": "pO2v0ZyCEOYRZy7SXcsb2fGvTvfYRUxAlz4NHLG1H44",
"path": [
{
"witnesses": [
{
"timestamp": 1608738987154888200,
"snr": -11.199999809265137,
"signal": -106,
"packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis",
"owner": "13s2SCJbWP9ZmGW5uULCehV7EJRDdYqLrmNCQCtoj5Y1RDerZAq",
"location": "8c2ab38f1d5c9ff",
"is_valid": true,
"gateway": "112GGQtavNrmWhEoLd5ABF1fbfXLccS747ez1dZHoh9TvgjJw29p",
"frequency": 904.5,
"datarate": "SF9BW125",
"channel": 3
},
{
"timestamp": 1608738987176681500,
"snr": -5.5,
"signal": -106,
"packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis",
"owner": "13s2SCJbWP9ZmGW5uULCehV7EJRDdYqLrmNCQCtoj5Y1RDerZAq",
"location": "8c2ab38f1da8bff",
"is_valid": true,
"gateway": "11uHyX8PJhk7kqRiW2JaF2dR2PGVX8vB7FcQXVW6M1rY2BbuQHU",
"frequency": 904.5,
"datarate": "SF9BW125",
"channel": 3
},
{
"timestamp": 1608738987229829600,
"snr": 3,
"signal": -119,
"packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis",
"owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx",
"location": "8c2ab38f19a43ff",
"is_valid": false,
"gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"frequency": 904.5,
"datarate": "SF9BW125",
"channel": 3
}
],
"receipt": {
"timestamp": 1608738985817671400,
"snr": 0,
"signal": 0,
"origin": "p2p",
"gateway": "11nCHecDUTkDxMNfAuMjF8cev7bfoKetWj4Y1MWDoSstDGhbMSs",
"frequency": 0,
"datarate": null,
"data": "W1k",
"channel": 0
},
"geocode": {
"short_street": "Bridge Ave",
"short_state": "OH",
"short_country": "US",
"short_city": "Cleveland",
"long_street": "Bridge Avenue",
"long_state": "Ohio",
"long_country": "United States",
"long_city": "Cleveland",
"city_id": "Y2xldmVsYW5kb2hpb3VuaXRlZCBzdGF0ZXM"
},
"challengee_owner": "13JyFksMcfyMTpycMy1XStssPWcQJut61n68sMUhG1cJQBmwUWi",
"challengee_lon": -81.70946661837299,
"challengee_location": "8c2ab38f56003ff",
"challengee_lat": 41.48413978192872,
"challengee": "11nCHecDUTkDxMNfAuMjF8cev7bfoKetWj4Y1MWDoSstDGhbMSs"
}
],
"onion_key_hash": "doMVn-c8K7SnduqUU4CJFGloUeAMB0pYRcOkTrAyt4Y",
"height": 644054,
"hash": "QKjdegKY_muFONmC3mbwKjlCP4BaR9zCsXZSanKQWgY",
"fee": 0,
"challenger_owner": "13hc8BeaE5kUiMYW1FLU8dnV4t2XUM4sWxHxM2E34NF3tnJdiXj",
"challenger_lon": -73.93747871760092,
"challenger_location": "8c2a100dc6dd5ff",
"challenger_lat": 40.697659486078635,
"challenger": "11eqcRNEgAk7vioFtgtTWUERyV98Vj5iDEm75YMbUCS3uaLKFXR"
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}Pending Transactions for Account
Fetches the outstanding transactions for the given account.
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
Response
{
"data": [
{
"created_at": "2020-04-30T18:13:17.411141Z",
"failed_reason": "",
"hash": "IUXgVfnYPlv_Br3Rhng6bKTaLb_AzX9DC3E9NGJhAKs",
"status": "pending",
"txn": {
"fee": 0,
"nonce": 6,
"payer": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W",
"payments": [
{
"amount": 2,
"payee": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W"
}
],
"signature": "TcB6zhMf6_ImaMyuTbWRd33W-hlzCwxxZtyIeJRQwUTvHN00V1U4Jn7ooyNHjFAoBgvxBDN2VmQ5Fez0OQoICA"
},
"type": "payment_v2",
"updated_at": "2020-04-30T18:47:19.960477Z"
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}Rewards for an Account
Returns reward entries by block and gateway for a given account in a timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
Path Parameters
Query Parameters
Name
Tags
Description
Example
Type
optional
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
text
Response
{
"data": [
{
"created_at": "2020-04-30T18:13:17.411141Z",
"failed_reason": "",
"hash": "IUXgVfnYPlv_Br3Rhng6bKTaLb_AzX9DC3E9NGJhAKs",
"status": "pending",
"txn": {
"fee": 0,
"nonce": 6,
"payer": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W",
"payments": [
{
"amount": 2,
"payee": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W"
}
],
"signature": "TcB6zhMf6_ImaMyuTbWRd33W-hlzCwxxZtyIeJRQwUTvHN00V1U4Jn7ooyNHjFAoBgvxBDN2VmQ5Fez0OQoICA"
},
"type": "payment_v2",
"updated_at": "2020-04-30T18:47:19.960477Z"
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}Reward Totals for an Account
Returns reward entries by block and gateway for a given account in a timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
Path Parameters
The results can be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed per hotspot and time for the account to make hotspot performance comparison possible. Valid bucket values include hour, day and week).
Query Parameters
Name
Tags
Description
Example
Type
required
First time to include rewards sum for.
2020-08-27T00:00:00Z
ISO8601 timestamp or relative time
Response
{
"data": {
"max_time": "2020-08-29T00:00:00Z",
"min_time": "2020-08-27T00:00:00Z",
"sum": "176714898"
}
}Stats for Account
Fetches account statistics for a given account. This currently includes account balance information (in bones) for the last month (daily), last week (every 8 hours), and daily (hourly)
Path Parameters
Response
{
"data": {
"last_week": [
{
"timestamp": "2020-12-24T00:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T16:00:00.000000Z",
"balance": 2726579175524
},
{
"timestamp": "2020-12-23T08:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T00:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-22T16:00:00.000000Z",
"balance": 2725942362517
},
{
"timestamp": "2020-12-22T08:00:00.000000Z",
"balance": 2725650289654
},
{
"timestamp": "2020-12-22T00:00:00.000000Z",
"balance": 2725147917954
},
{
"timestamp": "2020-12-21T16:00:00.000000Z",
"balance": 2724406718606
},
{
"timestamp": "2020-12-21T08:00:00.000000Z",
"balance": 2724056284882
},
{
"timestamp": "2020-12-21T00:00:00.000000Z",
"balance": 2723209316840
},
{
"timestamp": "2020-12-20T16:00:00.000000Z",
"balance": 2722951323859
},
{
"timestamp": "2020-12-20T08:00:00.000000Z",
"balance": 2722934379280
},
{
"timestamp": "2020-12-20T00:00:00.000000Z",
"balance": 2722897458808
},
{
"timestamp": "2020-12-19T16:00:00.000000Z",
"balance": 2722688076583
},
{
"timestamp": "2020-12-19T08:00:00.000000Z",
"balance": 2722582293089
},
{
"timestamp": "2020-12-19T00:00:00.000000Z",
"balance": 2722544226107
},
{
"timestamp": "2020-12-18T16:00:00.000000Z",
"balance": 2722495151953
},
{
"timestamp": "2020-12-18T08:00:00.000000Z",
"balance": 2720896037594
},
{
"timestamp": "2020-12-18T00:00:00.000000Z",
"balance": 2720485905293
},
{
"timestamp": "2020-12-17T16:00:00.000000Z",
"balance": 2719886473562
},
{
"timestamp": "2020-12-17T08:00:00.000000Z",
"balance": 2719278670960
},
{
"timestamp": "2020-12-17T00:00:00.000000Z",
"balance": 2719231394336
}
],
"last_month": [
{
"timestamp": "2020-12-24T00:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T00:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-22T00:00:00.000000Z",
"balance": 2725147917954
},
{
"timestamp": "2020-12-21T00:00:00.000000Z",
"balance": 2723209316840
},
{
"timestamp": "2020-12-20T00:00:00.000000Z",
"balance": 2722897458808
},
{
"timestamp": "2020-12-19T00:00:00.000000Z",
"balance": 2722544226107
},
{
"timestamp": "2020-12-18T00:00:00.000000Z",
"balance": 2720485905293
},
{
"timestamp": "2020-12-17T00:00:00.000000Z",
"balance": 2719231394336
},
{
"timestamp": "2020-12-16T00:00:00.000000Z",
"balance": 2716992988275
},
{
"timestamp": "2020-12-15T00:00:00.000000Z",
"balance": 2714499571334
},
{
"timestamp": "2020-12-14T00:00:00.000000Z",
"balance": 2712996222990
},
{
"timestamp": "2020-12-13T00:00:00.000000Z",
"balance": 2703175106511
},
{
"timestamp": "2020-12-12T00:00:00.000000Z",
"balance": 2701913148104
},
{
"timestamp": "2020-12-11T00:00:00.000000Z",
"balance": 2699717238347
},
{
"timestamp": "2020-12-10T00:00:00.000000Z",
"balance": 2698120119399
},
{
"timestamp": "2020-12-09T00:00:00.000000Z",
"balance": 2696104012737
},
{
"timestamp": "2020-12-08T00:00:00.000000Z",
"balance": 2694835982946
},
{
"timestamp": "2020-12-07T00:00:00.000000Z",
"balance": 2692158753830
},
{
"timestamp": "2020-12-06T00:00:00.000000Z",
"balance": 2689398873651
},
{
"timestamp": "2020-12-05T00:00:00.000000Z",
"balance": 2687488073405
},
{
"timestamp": "2020-12-04T00:00:00.000000Z",
"balance": 2686193207861
},
{
"timestamp": "2020-12-03T00:00:00.000000Z",
"balance": 2684790604843
},
{
"timestamp": "2020-12-02T00:00:00.000000Z",
"balance": 2682678566170
},
{
"timestamp": "2020-12-01T00:00:00.000000Z",
"balance": 2680802668931
},
{
"timestamp": "2020-11-30T00:00:00.000000Z",
"balance": 2679059221953
},
{
"timestamp": "2020-11-29T00:00:00.000000Z",
"balance": 2677312562564
},
{
"timestamp": "2020-11-28T00:00:00.000000Z",
"balance": 2675534596168
},
{
"timestamp": "2020-11-27T00:00:00.000000Z",
"balance": 2674031525165
},
{
"timestamp": "2020-11-26T00:00:00.000000Z",
"balance": 2673184081131
},
{
"timestamp": "2020-11-25T00:00:00.000000Z",
"balance": 2671270944491
},
{
"timestamp": "2020-11-24T00:00:00.000000Z",
"balance": 2669603645697
}
],
"last_day": [
{
"timestamp": "2020-12-23T19:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T18:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T17:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T16:00:00.000000Z",
"balance": 2726579175524
},
{
"timestamp": "2020-12-23T15:00:00.000000Z",
"balance": 2726579175524
},
{
"timestamp": "2020-12-23T14:00:00.000000Z",
"balance": 2726322880219
},
{
"timestamp": "2020-12-23T13:00:00.000000Z",
"balance": 2726322880219
},
{
"timestamp": "2020-12-23T12:00:00.000000Z",
"balance": 2726306228185
},
{
"timestamp": "2020-12-23T11:00:00.000000Z",
"balance": 2726306228185
},
{
"timestamp": "2020-12-23T10:00:00.000000Z",
"balance": 2726306228185
},
{
"timestamp": "2020-12-23T09:00:00.000000Z",
"balance": 2726252381243
},
{
"timestamp": "2020-12-23T08:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T07:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T06:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T05:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T04:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T03:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T02:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-23T01:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-23T00:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-22T23:00:00.000000Z",
"balance": 2726184001677
},
{
"timestamp": "2020-12-22T22:00:00.000000Z",
"balance": 2726184001677
},
{
"timestamp": "2020-12-22T21:00:00.000000Z",
"balance": 2726184001677
},
{
"timestamp": "2020-12-22T20:00:00.000000Z",
"balance": 2725942362517
},
{
"timestamp": "2020-12-22T19:00:00.000000Z",
"balance": 2725942362517
}
]
}
}Last updated
Was this helpful?