List Accounts
Retrieve basic stats for the blockchain such as total token supply, and average block and election times over a number of intervals.
Query Parameters
Cursor for page to fetch. Note: The cursor for accounts is valid for a limited time.
eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0
Response
Copy {
"data": [
{
"sec_nonce": 0,
"sec_balance": 0,
"nonce": 2,
"dc_nonce": 0,
"dc_balance": 0,
"block": 435239,
"balance": 0,
"address": "13etjTqyGLK7WQh8pp9VJy5ejh5MXmwFee2eAi3TfAA5kS1jEJb"
},
{
"sec_nonce": 0,
"sec_balance": 0,
"nonce": 0,
"dc_nonce": 0,
"dc_balance": 0,
"block": 435239,
"balance": 179087000000,
"address": "14Xg1SqiJDsmM2YvchR4UacevcuxjfyrjdyNEpRMmfBU7vrZba9"
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}
List Richest Accounts
Returns up to 100 of the accounts sorted by highest token balance.
Query Parameters
Number of accounts to return. Default 100, max 100.
Response
Copy {
"data": [
{
"address": "1398hLeHESZHE5jVtaLAV5fdg2vrUeZEs2B92t7TzeQTtugr8dL",
"balance": 616416488712965,
"block": 489719,
"dc_balance": 0,
"dc_nonce": 0,
"nonce": 3,
"sec_balance": 351543978600,
"sec_nonce": 0
},
{
"address": "14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S",
"balance": 292033864604925,
"block": 489719,
"dc_balance": 0,
"dc_nonce": 0,
"nonce": 0,
"sec_balance": 166398670100,
"sec_nonce": 0
}
]
}
Account for Address
Retrieve a specific account record. The account details for a record include additional speculative nonces that indicate what the expected nonce for the account is for a specific balance. Any transactions affecting the given balance type should use an adjusted speculative nonce for that balance type.
Path Parameters
Account B58 address to fetch details for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Response
Copy {
"data": {
"address": "1122ZQigQfeeyfSmH2i4KM4XMQHouBqK4LsTp33ppP3W2Knqh8gY",
"balance": 0,
"block": 311833,
"dc_balance": 100000000000000,
"dc_nonce": 0,
"nonce": 0,
"sec_balance": 0,
"sec_nonce": 0,
"speculative_nonce": 0
}
}
Hotspots for Account
Fetches hotspots owned by a given account address.The list of returned hotspots is paged. If a cursor field is present more results are available.
Path Parameters
Account B58 address to fetch hotspots for.
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of hotspots to fetch.
Response
Copy {
"data": [
{
"lng": -81.70707772367822,
"lat": 41.480133219396784,
"status": {
"online": "online",
"height": 435166,
"gps": "good_fix"
},
"score_update_height": 435153,
"score": 0.9222412109375,
"owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx",
"nonce": 1,
"name": "sneaky-violet-penguin",
"location": "8c2ab38f19a43ff",
"geocode": {
"short_street": "W 32nd St",
"short_state": "OH",
"short_country": "US",
"short_city": "Cleveland",
"long_street": "West 32nd Street",
"long_state": "Ohio",
"long_country": "United States",
"long_city": "Cleveland",
"city_id": "Y2xldmVsYW5kb2hpb3VuaXRlZCBzdGF0ZXM"
},
"block_added": 96087,
"block": 435241,
"address": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB"
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}
OUIs for Account
Fetches OUIs owned by a given account address.The list of returned OUIs is paged. If a cursor field is present more results are available.
https://docs.helium.com/use-the-network/buy-an-oui/
Path Parameters
Account B58 address to fetch OUIs for.
13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc
Query Parameters
Cursor for the next page of OUIs to fetch.
Response
Copy {
"data": [
{
"subnets": [
{
"mask": 8388352,
"base": 0
}
],
"owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc",
"oui": 1,
"nonce": 0,
"block": 762440,
"addresses": [
"112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
]
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}
Activity for Account
Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
Path Parameters
Account B58 address to fetch activity for.
13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx
Query Parameters
Cursor for the next page of activity to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"data": [
{
"type": "rewards_v1",
"time": 1608741833,
"start_epoch": 644049,
"rewards": [
{
"type": "poc_challengers",
"gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"amount": 8423208,
"account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
}
],
"height": 644084,
"hash": "6A_8hid6ZIiyg32dzQwFajM-iDyAvYJdVccSpxyymi8",
"end_epoch": 644083
},
{
"type": "rewards_v1",
"time": 1608691560,
"start_epoch": 643255,
"rewards": [
{
"type": "poc_challengers",
"gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"amount": 8639175,
"account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
}
],
"height": 643353,
"hash": "jd5mq1OMG1q7g_JNJr5gFHD17uMSawvFNt8ARty2OGQ",
"end_epoch": 643352
}
],
"cursor": "eyJoZWlnaHQiOjQzNTIzOSwiYmVmb3JlX2Jsb2NrIjo0MTM3MDIsImJlZm9yZV9hZGRyZXNzIjoiMTRpdndTNnRBQXVzRFo0QXVucTZXZ2dUc285cEZFbXZ2eXM5S1NXYUJDRENMd1UyMURkIn0"
}
Activity Counts for Account
Fetches transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
Count transactions that indicate activity for an account. This includes any transaction that involves the account, usually as a payer, payee or owner.
The results are a map keyed by the given filter_types
and the count of transaction of that type.
Path Parameters
Account B58 address to fetch activity counts for.
13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx
Transaction Types
Append the version on the transaction type name, eg: payment_v1
add gateway
- Add a new gateway to the Helium Network. For the purposes of transactions, a “gateway” is the term for a Helium-compliant Miner that is mining and providing coverage.
assert location
- Assert a gateway’s location on the Helium Network. This happens after a gateway has been added via the add gateway transaction. Once asserted, this location is then used as part of Proof of Coverage challenges. A Miner’s location can be asserted more than once but each subsequent assertion will a) cost a fee and b) reset that Miner’s score to neutral (.15)
chain vars
- Change a chain variable.
coinbase
- Similar to the bitcoin blockchain’s coinbase transaction but used only during testnet phases of the Helium blockchain. The rewards
transaction has taken its place.
coinbase data credits
- Created the initial 10,000 Data Credits required to bring the first group of Miners online.
consensus group
- Marks the election of a new consensus group, responsible for mining during the next epoch.
create hashed timelock
- Creates a transaction that can only be redeemed by providing the correct pre-image to the hashlock within the specified timelock.
create proof of coverage request
- Submitted by a Miner wishing to initiate a challenge.
data credits
- Burn HNT for DCs at the current oracle price and deliver them to the target wallet address.
genesis gateway
- Used to define the initial group of Miners that bootstrapped the blockchain.
multi-payment
- Used to send $HNT from one wallet to multiple wallets.
OUI
- Create a OUI for a new router on the Helium network. In the Helium blockchain, Miners forward packets to Routers that own them based on their OUI as stored in the blockchain.
payment
- Used to send $HNT from one wallet to another.
proof of coverage receipts
- The result of a POC submitted to the network upon completion.
redeem hashed timelock
- Redeem the transaction created using the create hashed timelock transaction.
reward
- A token payout for a specific event on the network such as submitting a valid proof of coverage request, participating in a consensus group, etc.
rewards
- Bundles multiple reward transactions at the end of each epoch and distributes all $HNT produced in that block to wallets that have earned them.
routing
- Update the routing information associated with an OUI.
security coinbase
- Distribution of security tokens in the genesis block.
security exchange
- The transfer of security tokens from one address to another.
state channel open
- Opens a new state channel on a Helium Router
state channel close
- Closes a specific state channel on a Helium Router
token burn exchange rate
- Change the exchange rate for burning $HNT to DCs.
Query Parameters
Comma separated list of transaction types.
Response
Copy {
"data": {
"vars_v1": 0,
"transfer_hotspot_v1": 3,
"token_burn_v1": 0,
"token_burn_exchange_rate_v1": 0,
"state_channel_open_v1": 0,
"state_channel_close_v1": 0,
"security_exchange_v1": 0,
"security_coinbase_v1": 0,
"routing_v1": 0,
"rewards_v2": 1082,
"rewards_v1": 9180,
"redeem_htlc_v1": 0,
"price_oracle_v1": 0,
"poc_request_v1": 0,
"poc_receipts_v1": 0,
"payment_v2": 16,
"payment_v1": 11,
"oui_v1": 0,
"gen_gateway_v1": 0,
"dc_coinbase_v1": 0,
"create_htlc_v1": 0,
"consensus_group_v1": 0,
"coinbase_v1": 0,
"assert_location_v2": 2,
"assert_location_v1": 4,
"add_gateway_v1": 5
}
}
Elections for Account
Fetches elections that hotspots for the given account are elected in.
https://docs.helium.com/blockchain/consensus-protocol/
Path Parameters
Account B58 address to fetch elections for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of elections to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"data": [
{
"type": "consensus_group_v1",
"time": 1608276577,
"proof": "g1AAAAdHeJxF1Hs403scB3BWZIdDuQxzadTRcctPSO5iLqedI3ILMwxDmEs4p6whSTEqyrbsnCNMSCObueS2Vi6VS3I8Cp1OF2zusllhzvpj_PX95_08r8_n_TzfT5yEhMT-aFC86NGRwI9ayb7Ga3lcJh9L0qTkHXXTzr0HL1YSTO5lofGR6DvfU26AC0hHgrZ968eJF4KzjfhZcqHsq9FQiDbfIAwZfzWO-s_GSyQPBAvu9PkmlT5U4SBpziI1YK9EZZNrZzy-DTu5_5CJOQs3E5urJbDq5UVW1ifX0s4CqeduzYBzvw3lRhcgs6cOnA_gxCbMc9tU8TBXcWLDXmi0gL6kKDtqbvXA-ogHm5asq4k7ZCCaql21vQnp98hV_8_Fr4duN7XFpZgBi3gpKWX-pUDV95mqYjPOIv55Q-o2CpY6NtDeL2ArzIQQaertsFGjA8cslzmGO2YGvmH-Yf7fI3OWl4suvAxyOf22kK5tdOpnrvq1WdL21UqRWVJYZsJcCKoO13N6qon3DfCOfbJWHBYRN4TunpmQnbQUm8waaIO97appqLcX-yr2K7-LPTemCkvKq3ceP7RWA_HbMR3tsEfzvSN1CcoXx7D7KsMfMytU9yAXN7jFjqiCntu2IvNNzrevvJCbuNx2_mjSIjViwd_n2eCyCfCOmOAyBa2-JDYJnh82U4tyAGx2R4ulpFvX6B-NMYbtcGiJ0mO4xrs3WzumkkabPiGELzE-ciI7mQzgpnv-m1kCy1sfTy5A2ASXhYrMvhwBPD37Sm-JxMHgoG71dORWfxPeawaTP6z7PsDmk5rY_IHoKL1pO55BYGk_dpf1Znkaadw2-2Mf0boporKsu1ZuxzQn7g2P-sIFC-IpaPDWPR9gJKXup6gqoWkgO2jmRO-GyCQNIkiOLTJqbbJawFxa8786Foot8heF0bqLf8OJkQeWxKbRBy6mQiNxHFcw88C-3Z-gAyWjDRhJMdG8giTcEtPhe8oVgINgGrg6qI1ePUHtnLK3D73xLcbjdzdml9C42EKh1nPl1HkQzLq17jM_uvXHSsMi1uz8sTuJZueuSWZJywG_XWCWGyg6icktzBKcONINuS1EaBK-GDZ4rTdP3al25FmT2F-mafJV31PugKtoiQ0TOFcbFd6pwZGbBrPNnF9PMko-eCebTrk4dfZK6N343u21EU7xOPXVMCjjs9qiuhmwdn3vSUTfxK2zMiCi3QpEjP5Ll8su_GkPZfDyJatwq9cJtCs1KgxlSPkhJU4Um1cSstPtea3fwPgulyjrDNMIVULwfbPkWd7NM84G695IQWl3spbIpKZUXbCf3bfFA1B3H4LnSa2-vneHQy1cqz9rK1uknbMQm95BYPq9FOwZ0MJH81dHL5yW-vi0z9lKf8XPv8PDONtauHsTBnKGgAKbesgpbaU3jV9ttc80evnbOHZa6dLT4mgn3kJBMB_odf0y30wHGgB1LT2-UF-rz94_tOWe7m4WIwUJ9xGITVAgarxJYRpMVoupGS4mDef1DGRhOlKsuI9PnbZ-RNLaLXcKNdFzFHqP4WGy2heByqzm2hsvVdk9H2SsliLuXzzsLIpURQfWD0qvZabH5BXue3knB3er9KIm8_ikwn7I3LpJkbsY9eosDPVrApJ0wmdM0yq3InI9s5ZWY8OWqyzdYpB-NMEumptHf9hYGpXLw2EKKzL3q6j4zyrYTFelum79XmyXVnNCFLmV7vICT92kv6KUy9ycH7FTiaNFFjVIEEKiZt87vCiPFaMK_LmR1z4wAZ91TV2BQ1N6hm0ZW_aV1EL14Jrjbbs4u-0O24UGxGxWAj8fDGzSIHZQOj7KM39t7ZmrMJdjLVAYiSBYEg08GvqA8d86echrm9e_csw4sQeOQK_HCGqFe36R44jNywNZ_Hya3wirsvhu95DlmCHHJEt5NjJiOwHNTHiqwdv5LTIqG2VCLQopt41atJWKNMEi2uyff-gNroh_NJlYiMCCYAeaVB16GHW6BlRtB5sznF6VAMkKsnxTUlg1yog-bf5UTPp-mouFdgSYdrBHMQwNIoFYN57qLx0Ad9p8EtHP15_bXZOkgz_4jnukL-PPK-9B59dw6w4v_agIP4uPnU4HWzB5BSAYzLWMyA0bpkc3Q8DKSa3LA88SKjawieRVXBzaOkx6XmwiNxv0INkrD4nBb2DMFgKtumWZ-m5R7y9MWn6vXMeA-u7xO2wh74gLkgbL4KjIX5PpTHQ6AvRWQe1RF_j8-I2VRNFUtUPsctTggyP3p4ztVQWHIREnO-ueFMVSLC0Hrpd_wgjP_Q_ffiin",
"members": [
"112qqYc77fYcGLYrD5Bd1zG1dwoXGCzaQ63oby8ws9mhDrhieTRv",
"11hxEKmhr2xgVu8srSdkmoQYNVYYKppKd82mtanBbU5kd9r42hs",
"11LmZdUgSn5Pwa8a2Q16EUDfyLutpDeQoUgzgerHJc73p8NTC3V",
"112374TV64PVuBDDArCymuiqA6AQdNr3q9JVthoYo5r9kBCS6N3",
"1124oBcVaT6pubZWxuPisQs8hNKaYp9cduvQ9skcpRmt14LnhsnX",
"11eq43bdC6iAsQJtSsxbEwZZP9ECZX7QYnWXn95uc3Ajym9bdP6",
"112vbpLrhj8kQdBn8FDBYR2KcXVh95HmPfgyZfuA8kL5kRKVEWyc",
"112hX6sPHCgYXP98tdac5TqPNfU17t3K8ZwdpLd1UfFSD8Xoqv3H",
"115fXeCtfk9FjpoNXn8QCikp1GVGgGg2S5BXq8RJovcDvFrXrL8",
"11xrgEdiN9DA2cyauB29AXDy8WoMEwhqaL1chU83YWGx7q81sp8",
"11d13u5TospVvAD8pGCYNZR3GrEykB4osswni5fcXnonfHDSEpG",
"11diD2YbFNJ4yHDoWZpJErdJmwRsGEepCteEHfFMwakrTxjvMRG",
"112PSpVub6tJxekGMF4N3wp7Yb883pPWiF4WCw9BeuugXJucGZqB",
"11pf3gLhyFPRCedRPngEUu3Rr25sRYi16WRRS1ZYsA6hGMpkaXU",
"11zcBW5mQx2iJbNUg3MhvUEVbnB7Ty4dFL7Pgt2qvENZiNSotuV",
"1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB"
],
"height": 637456,
"hash": "mKX9qDdsbbHfkllXZJPmDnaWftsHeFxodSfyTPTSPMA",
"delay": 5
},
{
"type": "consensus_group_v1",
"time": 1607829748,
"proof": "g1AAAAdAeJxF0nk81IkbB_DxDZspsTFj5PqOa8XkmoZhLIZhpNySKzYy5Mo1SGKw5MiZIwxlI-YnJqac5UghlN-Oe2VD_LDGEZqc-emPmf3r-efzer1fn-d5_CEQiLAPEHA0kBAh9jJzyB7cZncmiwst1Yq8DWwaXb_MI-XWHd0YoNe-9CNlqk4AQAOqgbh50QFmI5Kp_3VTCXFyOOmbrs0pmt1tefcoKm82AGKiy_3Lr8_bmZ1krVea5ZI8WG6f0ZpN45I5zGCJM7pwDqmCLqpGZDWDY51dzX9IxooIRVS-C7vl-vfIaFR6-zQ55kfKTN0UQEIWYmPn2HE_X9VlwqvHpyEU0TXGUzquVAvVYf3wsmWW31GkTPDM-mQwYz1q-3mXyUcPwsxcNK3G4r4w_p-B3F0h4zgOylgDzjfx8wvwLkbYlyB08Gnza5jJtRcDend7JyMe1m5xe2ram_Hgf_uwTVGr6VNyoWwKUij-D0zmbXpZ6jTcBVseAAzB3kg77eq_FzD_UhtDlihEiRqv89992AwPn8A7a9MdOGRzptCrxy91zFRp29WOSS9Las9lftTPXbXqPrco75cKq-OS0Fq4Uv59Z3mPnZTcleE0JHaAkLqbLmqNeGCbiVwtqAfAIHP9Te1Cvs-GKLV7MpJTlinzLFtrTcQMIuep4EkXArflAY7xrTFD5aGyBk9JlKT7PjEbfrgTautxwSWF7bTr2PMjRVQ3AUBDimV_3tn2WGxseW7VqgI8attd-8NysMvX8GLUtY3WhaPN1hLn0svarhokH0KGxiPZPzVgze0QEdCE4gUFmUQfnSKOKVf8Aj2AluEF0oYvYuXqQkdLKqETig0nnj_plJjwCV7imp4dQS4336igMhRUvl32tz-t3Nq6WZ-b73BtJ8rO0YqVf2SuTGNJyAPlDvtH_SfNvd5q1PMcOPJn3RpBa-ChqQreORxzh68zaOubbyGx73a6qN5u_pdPnR-Dyn0TparvMFBKsBzuaiXv8H2JjOha45-JzhIND6wzPz6ncvP5TT_cMgEu_tgNB4AK_ego2nSIsDDrU7j3Y9jGg_Phw8GvWj7oxruZeSrqm3NIAatLoVcrGKWk-KfP5a3yvKpijdoyQv35W5LDyjv4q_r__dqhzrkPTnVSytmWj1U-7wyZylu80Y2GkmLRjNmumRMEp6PIX8fIzdTj5Jmhcniiwb2oQPk_arZaPIstsHVO0HwV3rMc9CI58qpmSLUNRqnooEjv2UQTkneS7iXo6vyxV9dgPIDK7WmUerPmN9n3S-6xZ1jltnp0_lnZhEv7pe6D0LYeq0IbBwB0qd1CXBr8UnvhzQhhr1Slqo_pYrkHTaMJ-GhbtOvIZ3DIXwgNi9R7OOFJI5K4qOkTdcuznSsLX8BG_aS0FTjLNPDfno1jsnNxIh3f8-OW70rTM3suHuxXaOiHGOQJtRh6JZitH0V69bYrYnpo0rqNWXggSBslTdQ8rQCaZFfGA7t4i20ZDvrsUHWYHWm4kT_rqfqoi1iHO7Vh_bt48s8IvqATbPGV69wfso1eIkt00MeV1fbwKdRmI50_8Q0nNmNkzTKqxLI6Mm2PzLGY0VZ0PZg9cAPULAElRu6IGOeEA3KwGUNrY7_DUirHFJMuel9RSjVnrGOKM5PsVh2anXa8eeuQRp5kknmF7VOOiYTMZq1mrLSL5cV3hyWUFuQZYlIUFwcnZn-KN73xH74h6SoAlLq898Ak5J8GxRZFy8lTG2nvy3K0pJT1AsoiBYZTjftCOKZSmZ8yOgV-ilgRoa2Gp4XtetiEHgvW0j004UMGer7Dcu95B0lyGlAM1rxPQJPqnVFeJCOpqA7XwoQYXPct5lDzAACam_oCC8eu9ZdVv2AGFfye_exKmKVWxmgihrgtbDYFQ3FIG4B9vQx3zbbO74WqGnn_9WvcFciIxpi_tNUrbMrfrx9xSQ1_9dv0OSNHFZrlse2xiK24830JwRTK56mIwEGC4T4fABJXFb_nYNAW00liuZVNWahxjRqtd0bQHPFLfoycniuqHHL1vXhFsuMmHe_EU8D4n6RIcUlvYxvsL3kHCoM-iQA-cUk3I1bGlunaV797lD9fKX8iEKckL6Ql7MxGqvlA1iMFCwDw-JNO01vjNJu8aWavmOi5g5Bfy2Gw0NGhROwYKh1848khjxML5VqboXJTNd0YxjyZ3lutX9Lx_S2MzT58AktOGeCSUisTiyWPfsnM_69vFtXh12mDLQR1efCcjvWEzJhmG2oZAFHrGz6uMW9nyry_M1lht8E2byY_yeXQGaaTKitAdlHz_T_1TBOF",
"members": [
"11GgZk795fcucYYaCz6f3iXJpR8iA5FVBJFgYzFbdeciXVacrke",
"1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"11aEVjsaJN7gfjggGvFuGEgixQVRtkWzEpzX15YHiZJkLSsuwdv",
"112Lx9Tren485XT7PvY7GHnmUVMTvyjwZ6hrxL7ozeDvqE7Jy6pA",
"11L2XXdnBjVmJiyb86yLyhbkg75VYEjSx9D6qMKYdsS3mnJzXoS",
"11JtrTKA3wGNE2Fgep5HLC2B3YTRDsAt4vNc7GEsVp8Y7nYKGz1",
"11JJ4RR6oPbpVouU1rzkRQC9T4VavDZrbbPaes8FVoD33uyxHQV",
"11cgLFT851vXJT4iAno1G89kct7qVM4H17EYrbJmZBuJhAyuvgD",
"112vXW9jvfNKVzWGfMYZhEmBxbGVro5iNZmUWiermAXgRebac3Pa",
"112NFATPKh4y7dXudyM9NwFwxzoLYHbX5eFzMjbQtCXTnQJrL1Ze",
"11BBZMfB8c8L3V5YVQ8KSTsVF9gx5HFcDyB5c2S1E2g86w7UPdc",
"1156oi8swcmxmR4RGM7fGHFA2JP4Lk4UjXL11tcxZQGCqfh58Po",
"112tfwpKvCqwDfzsfyAnQwj7gbmx59zKCKDaxBsmCZ4pPBd8Gasv",
"112QirNzqW2LuGAuorXA68mr9qiuWnaEALFPkeBi5AK5S5gccRjS",
"112pArcjJA6mPKAFVifkK84YVkVUro5iWh2TSbTwBcV7xrsyQyQ2",
"114eVcYfr3ujqUGsEKs1pJQQGAJTA5Lf4JgG9BjVmKnodr41Q5q"
],
"height": 629706,
"hash": "c8gPYHwWpEGHMLhDynUHHw1k-qhW61JBPW8Q4kTlic0",
"delay": 5
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}
Challenges for Account
Fetches challenges that hotspots owned by the given account are involved in as a challenger, challengee, or witness.
Path Parameters
Account B58 address to fetch challenges for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of challenges to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"data": [
{
"type": "poc_receipts_v1",
"time": 1608740853,
"secret": "AEGM923859xCnALUTWtVzYIkRKXAL4E0Ss1JRchMhhMdBOhuXOob79UwlghHhEZN2ChZe7vvnltg8Z2D-adlb-kkL-hv_ONvpcsFXPw9y_LYzIwTS7TAIVbqKfuBn_IVRcc",
"request_block_hash": "JTUr-_hX--L6TuwIkx-DEzeB--yMheo2Ud-yZ4LNVt4",
"path": [
{
"witnesses": [
{
"timestamp": 1608740090285495600,
"snr": -9,
"signal": -100,
"packet_hash": "p2ZijVno8DHGJui_bV6u-tABHQOiEB_c3NCFOv_-1xE",
"owner": "146MwmL9eJJCdrykbgdL3dobdChP4Ut34mCZMR3Hv9HXTeBJQzC",
"location": "8c44a105ca1d3ff",
"is_valid": true,
"gateway": "11fJaz1xwA2Xh1gQQWRh6FzDabEPkLs5bSMdDnSrb4CL1L5Y5Su",
"frequency": 905.2999877929688,
"datarate": "SF9BW125",
"channel": 7
}
],
"receipt": {
"timestamp": 1608740088868575200,
"snr": 0,
"signal": 0,
"origin": "p2p",
"gateway": "112V5U5MSMVBDTe6cCzWEXzuCbjK96GbKXwDPFSCyjeVnL3wHk5L",
"frequency": 0,
"datarate": null,
"data": "5_w",
"channel": 0
},
"geocode": {
"short_street": "Leslie Dr",
"short_state": "FL",
"short_country": "US",
"short_city": "Hallandale Beach",
"long_street": "Leslie Drive",
"long_state": "Florida",
"long_country": "United States",
"long_city": "Hallandale Beach",
"city_id": "aGFsbGFuZGFsZSBiZWFjaGZsb3JpZGF1bml0ZWQgc3RhdGVz"
},
"challengee_owner": "1444k99dYKjngxQnqGxrB3CmqaFdGzPRWsxqbbu3LjjCyBocGhi",
"challengee_lon": -80.12177083059214,
"challengee_location": "8c44a10564825ff",
"challengee_lat": 25.9903614158387,
"challengee": "112V5U5MSMVBDTe6cCzWEXzuCbjK96GbKXwDPFSCyjeVnL3wHk5L"
}
],
"onion_key_hash": "I86cUPLZ46naXW6IFhhXGVFeKftMi4FhtpsJwtW03T8",
"height": 644070,
"hash": "Z5yrO_XbwTT89xFjA1_3OlSke1KmkJ7VZmigd7NDVk8",
"fee": 0,
"challenger_owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx",
"challenger_lon": -81.70707772367822,
"challenger_location": "8c2ab38f19a43ff",
"challenger_lat": 41.480133219396784,
"challenger": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB"
},
{
"type": "poc_receipts_v1",
"time": 1608739733,
"secret": "ABCXJG0PUoO0iyTzvmd-XPVfJdPW3HBztPWjld7TLvOtBA-1qOjN6UNWkVmPp69FkUrnqZmJr1Zz-H-4v1lu7HGaABQ0p3X_Ge4hNZ6b2SpijiqUYf7i9JjgxzwMUtvy8bg",
"request_block_hash": "pO2v0ZyCEOYRZy7SXcsb2fGvTvfYRUxAlz4NHLG1H44",
"path": [
{
"witnesses": [
{
"timestamp": 1608738987154888200,
"snr": -11.199999809265137,
"signal": -106,
"packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis",
"owner": "13s2SCJbWP9ZmGW5uULCehV7EJRDdYqLrmNCQCtoj5Y1RDerZAq",
"location": "8c2ab38f1d5c9ff",
"is_valid": true,
"gateway": "112GGQtavNrmWhEoLd5ABF1fbfXLccS747ez1dZHoh9TvgjJw29p",
"frequency": 904.5,
"datarate": "SF9BW125",
"channel": 3
},
{
"timestamp": 1608738987176681500,
"snr": -5.5,
"signal": -106,
"packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis",
"owner": "13s2SCJbWP9ZmGW5uULCehV7EJRDdYqLrmNCQCtoj5Y1RDerZAq",
"location": "8c2ab38f1da8bff",
"is_valid": true,
"gateway": "11uHyX8PJhk7kqRiW2JaF2dR2PGVX8vB7FcQXVW6M1rY2BbuQHU",
"frequency": 904.5,
"datarate": "SF9BW125",
"channel": 3
},
{
"timestamp": 1608738987229829600,
"snr": 3,
"signal": -119,
"packet_hash": "zgFKUHVz-ZZa-Wk4h_XwCtB9TcJGvBZRNynSTMaEyis",
"owner": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx",
"location": "8c2ab38f19a43ff",
"is_valid": false,
"gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
"frequency": 904.5,
"datarate": "SF9BW125",
"channel": 3
}
],
"receipt": {
"timestamp": 1608738985817671400,
"snr": 0,
"signal": 0,
"origin": "p2p",
"gateway": "11nCHecDUTkDxMNfAuMjF8cev7bfoKetWj4Y1MWDoSstDGhbMSs",
"frequency": 0,
"datarate": null,
"data": "W1k",
"channel": 0
},
"geocode": {
"short_street": "Bridge Ave",
"short_state": "OH",
"short_country": "US",
"short_city": "Cleveland",
"long_street": "Bridge Avenue",
"long_state": "Ohio",
"long_country": "United States",
"long_city": "Cleveland",
"city_id": "Y2xldmVsYW5kb2hpb3VuaXRlZCBzdGF0ZXM"
},
"challengee_owner": "13JyFksMcfyMTpycMy1XStssPWcQJut61n68sMUhG1cJQBmwUWi",
"challengee_lon": -81.70946661837299,
"challengee_location": "8c2ab38f56003ff",
"challengee_lat": 41.48413978192872,
"challengee": "11nCHecDUTkDxMNfAuMjF8cev7bfoKetWj4Y1MWDoSstDGhbMSs"
}
],
"onion_key_hash": "doMVn-c8K7SnduqUU4CJFGloUeAMB0pYRcOkTrAyt4Y",
"height": 644054,
"hash": "QKjdegKY_muFONmC3mbwKjlCP4BaR9zCsXZSanKQWgY",
"fee": 0,
"challenger_owner": "13hc8BeaE5kUiMYW1FLU8dnV4t2XUM4sWxHxM2E34NF3tnJdiXj",
"challenger_lon": -73.93747871760092,
"challenger_location": "8c2a100dc6dd5ff",
"challenger_lat": 40.697659486078635,
"challenger": "11eqcRNEgAk7vioFtgtTWUERyV98Vj5iDEm75YMbUCS3uaLKFXR"
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}
Pending Transactions for Account
Fetches the outstanding transactions for the given account.
Path Parameters
Account B58 address to fetch pending transactions for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"data": [
{
"created_at": "2020-04-30T18:13:17.411141Z",
"failed_reason": "",
"hash": "IUXgVfnYPlv_Br3Rhng6bKTaLb_AzX9DC3E9NGJhAKs",
"status": "pending",
"txn": {
"fee": 0,
"nonce": 6,
"payer": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W",
"payments": [
{
"amount": 2,
"payee": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W"
}
],
"signature": "TcB6zhMf6_ImaMyuTbWRd33W-hlzCwxxZtyIeJRQwUTvHN00V1U4Jn7ooyNHjFAoBgvxBDN2VmQ5Fez0OQoICA"
},
"type": "payment_v2",
"updated_at": "2020-04-30T18:47:19.960477Z"
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}
Rewards for an Account
Returns reward entries by block and gateway for a given account in a timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
Path Parameters
Account B58 address to fetch pending transactions for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Query Parameters
Cursor for the next page of pending transactions to fetch.
eyJtaW5fYmxvY2siOjk2MDg3LCJibG9jayI6ODU4NzAwLCJhbmNob3JfYmxvY2siOjg1ODcwMH0
Response
Copy {
"data": [
{
"created_at": "2020-04-30T18:13:17.411141Z",
"failed_reason": "",
"hash": "IUXgVfnYPlv_Br3Rhng6bKTaLb_AzX9DC3E9NGJhAKs",
"status": "pending",
"txn": {
"fee": 0,
"nonce": 6,
"payer": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W",
"payments": [
{
"amount": 2,
"payee": "13C8mAv3M3SUQ1ZgREHsGxabcsHtDCkmkJLp9sGimqfWT4GRf9W"
}
],
"signature": "TcB6zhMf6_ImaMyuTbWRd33W-hlzCwxxZtyIeJRQwUTvHN00V1U4Jn7ooyNHjFAoBgvxBDN2VmQ5Fez0OQoICA"
},
"type": "payment_v2",
"updated_at": "2020-04-30T18:47:19.960477Z"
}
],
"cursor": "eyJiZWZvcmUiOjQzNTIwMX0"
}
Reward Totals for an Account
Returns reward entries by block and gateway for a given account in a timeframe. Timestamps are given in ISO 8601 format. The block that contains the max_time timestamp is excluded from the result.
Path Parameters
Account B58 address to fetch pending transactions for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
The results can be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed per hotspot and time for the account to make hotspot performance comparison possible. Valid bucket values include hour
, day
and week
).
Query Parameters
First time to include rewards sum for.
Last time to include rewards for.
Response
Copy {
"data": {
"max_time": "2020-08-29T00:00:00Z",
"min_time": "2020-08-27T00:00:00Z",
"sum": "176714898"
}
}
Stats for Account
Fetches account statistics for a given account. This currently includes account balance information (in bones) for the last month (daily), last week (every 8 hours), and daily (hourly)
Path Parameters
Account B58 address to fetch pending transactions for
14GWyFj9FjLHzoN3aX7Tq7PL6fEg4dfWPY8CrK8b9S5ZrcKDz6S
Response
Copy {
"data": {
"last_week": [
{
"timestamp": "2020-12-24T00:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T16:00:00.000000Z",
"balance": 2726579175524
},
{
"timestamp": "2020-12-23T08:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T00:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-22T16:00:00.000000Z",
"balance": 2725942362517
},
{
"timestamp": "2020-12-22T08:00:00.000000Z",
"balance": 2725650289654
},
{
"timestamp": "2020-12-22T00:00:00.000000Z",
"balance": 2725147917954
},
{
"timestamp": "2020-12-21T16:00:00.000000Z",
"balance": 2724406718606
},
{
"timestamp": "2020-12-21T08:00:00.000000Z",
"balance": 2724056284882
},
{
"timestamp": "2020-12-21T00:00:00.000000Z",
"balance": 2723209316840
},
{
"timestamp": "2020-12-20T16:00:00.000000Z",
"balance": 2722951323859
},
{
"timestamp": "2020-12-20T08:00:00.000000Z",
"balance": 2722934379280
},
{
"timestamp": "2020-12-20T00:00:00.000000Z",
"balance": 2722897458808
},
{
"timestamp": "2020-12-19T16:00:00.000000Z",
"balance": 2722688076583
},
{
"timestamp": "2020-12-19T08:00:00.000000Z",
"balance": 2722582293089
},
{
"timestamp": "2020-12-19T00:00:00.000000Z",
"balance": 2722544226107
},
{
"timestamp": "2020-12-18T16:00:00.000000Z",
"balance": 2722495151953
},
{
"timestamp": "2020-12-18T08:00:00.000000Z",
"balance": 2720896037594
},
{
"timestamp": "2020-12-18T00:00:00.000000Z",
"balance": 2720485905293
},
{
"timestamp": "2020-12-17T16:00:00.000000Z",
"balance": 2719886473562
},
{
"timestamp": "2020-12-17T08:00:00.000000Z",
"balance": 2719278670960
},
{
"timestamp": "2020-12-17T00:00:00.000000Z",
"balance": 2719231394336
}
],
"last_month": [
{
"timestamp": "2020-12-24T00:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T00:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-22T00:00:00.000000Z",
"balance": 2725147917954
},
{
"timestamp": "2020-12-21T00:00:00.000000Z",
"balance": 2723209316840
},
{
"timestamp": "2020-12-20T00:00:00.000000Z",
"balance": 2722897458808
},
{
"timestamp": "2020-12-19T00:00:00.000000Z",
"balance": 2722544226107
},
{
"timestamp": "2020-12-18T00:00:00.000000Z",
"balance": 2720485905293
},
{
"timestamp": "2020-12-17T00:00:00.000000Z",
"balance": 2719231394336
},
{
"timestamp": "2020-12-16T00:00:00.000000Z",
"balance": 2716992988275
},
{
"timestamp": "2020-12-15T00:00:00.000000Z",
"balance": 2714499571334
},
{
"timestamp": "2020-12-14T00:00:00.000000Z",
"balance": 2712996222990
},
{
"timestamp": "2020-12-13T00:00:00.000000Z",
"balance": 2703175106511
},
{
"timestamp": "2020-12-12T00:00:00.000000Z",
"balance": 2701913148104
},
{
"timestamp": "2020-12-11T00:00:00.000000Z",
"balance": 2699717238347
},
{
"timestamp": "2020-12-10T00:00:00.000000Z",
"balance": 2698120119399
},
{
"timestamp": "2020-12-09T00:00:00.000000Z",
"balance": 2696104012737
},
{
"timestamp": "2020-12-08T00:00:00.000000Z",
"balance": 2694835982946
},
{
"timestamp": "2020-12-07T00:00:00.000000Z",
"balance": 2692158753830
},
{
"timestamp": "2020-12-06T00:00:00.000000Z",
"balance": 2689398873651
},
{
"timestamp": "2020-12-05T00:00:00.000000Z",
"balance": 2687488073405
},
{
"timestamp": "2020-12-04T00:00:00.000000Z",
"balance": 2686193207861
},
{
"timestamp": "2020-12-03T00:00:00.000000Z",
"balance": 2684790604843
},
{
"timestamp": "2020-12-02T00:00:00.000000Z",
"balance": 2682678566170
},
{
"timestamp": "2020-12-01T00:00:00.000000Z",
"balance": 2680802668931
},
{
"timestamp": "2020-11-30T00:00:00.000000Z",
"balance": 2679059221953
},
{
"timestamp": "2020-11-29T00:00:00.000000Z",
"balance": 2677312562564
},
{
"timestamp": "2020-11-28T00:00:00.000000Z",
"balance": 2675534596168
},
{
"timestamp": "2020-11-27T00:00:00.000000Z",
"balance": 2674031525165
},
{
"timestamp": "2020-11-26T00:00:00.000000Z",
"balance": 2673184081131
},
{
"timestamp": "2020-11-25T00:00:00.000000Z",
"balance": 2671270944491
},
{
"timestamp": "2020-11-24T00:00:00.000000Z",
"balance": 2669603645697
}
],
"last_day": [
{
"timestamp": "2020-12-23T19:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T18:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T17:00:00.000000Z",
"balance": 2726587598732
},
{
"timestamp": "2020-12-23T16:00:00.000000Z",
"balance": 2726579175524
},
{
"timestamp": "2020-12-23T15:00:00.000000Z",
"balance": 2726579175524
},
{
"timestamp": "2020-12-23T14:00:00.000000Z",
"balance": 2726322880219
},
{
"timestamp": "2020-12-23T13:00:00.000000Z",
"balance": 2726322880219
},
{
"timestamp": "2020-12-23T12:00:00.000000Z",
"balance": 2726306228185
},
{
"timestamp": "2020-12-23T11:00:00.000000Z",
"balance": 2726306228185
},
{
"timestamp": "2020-12-23T10:00:00.000000Z",
"balance": 2726306228185
},
{
"timestamp": "2020-12-23T09:00:00.000000Z",
"balance": 2726252381243
},
{
"timestamp": "2020-12-23T08:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T07:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T06:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T05:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T04:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T03:00:00.000000Z",
"balance": 2726236453934
},
{
"timestamp": "2020-12-23T02:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-23T01:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-23T00:00:00.000000Z",
"balance": 2726227814759
},
{
"timestamp": "2020-12-22T23:00:00.000000Z",
"balance": 2726184001677
},
{
"timestamp": "2020-12-22T22:00:00.000000Z",
"balance": 2726184001677
},
{
"timestamp": "2020-12-22T21:00:00.000000Z",
"balance": 2726184001677
},
{
"timestamp": "2020-12-22T20:00:00.000000Z",
"balance": 2725942362517
},
{
"timestamp": "2020-12-22T19:00:00.000000Z",
"balance": 2725942362517
}
]
}
}