Accounts

List Accounts

GET https://api.helium.io/v1/accounts

Retrieve the current set of known accounts.The result is paged. A cursor field is present if more results are available.

Note: The cursor for accounts is valid for a limited time. If you receive a 400 http response code for a cursor based request, you will need to start fetching accounts from the beginning of the list.

Request
Response

Query Parameters

param	Type	Note
cursor (optional)	string	Cursor for the page of accounts to fetch

200: OK

{
  "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": 1,
      "dc_nonce": 0,
      "dc_balance": 0,
      "block": 435239,
      "balance": 0,
      "address": "14Vshtwv9RMY5GuTe1sgLDJmmF2f46EW3etEJzjDjhKJSEprtHh"
    },
    {
      "sec_nonce": 0,
      "sec_balance": 0,
      "nonce": 0,
      "dc_nonce": 0,
      "dc_balance": 0,
      "block": 435239,
      "balance": 404040732,
      "address": "14PaJeSfNp5Q3MtDw5yEsJwb2kHJqbcjjLe9aycjroqNFnL4EyS"
    },
    {
      "sec_nonce": 0,
      "sec_balance": 0,
      "nonce": 0,
      "dc_nonce": 0,
      "dc_balance": 0,
      "block": 435239,
      "balance": 1025990703,
      "address": "13rUthiDQUeY9HfwoZFpkqtsbtaubzRyerCsSu1qdDXuVZGL45k"
    },
    {
      "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

GET https://api.helium.io/v1/accounts/rich

Returns up to 100 of the accounts sorted by highest token balance.

Request
Response

Query Parameters

param	Type	Note
limit (optional)	string	Number of accounts to return. Default 100, max 100

200: OK

Result for /v1/accounts/rich?limit=2

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

GET https://api.helium.io/v1/accounts/: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.

For example, when constructing a payment transaction, get the speculative_nonce field for the source account and use speculative_nonce + 1 for the new transaction nonce.Currently only the speculative_nonce is supported. It indicates the expected nonce for the account

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch details for

200: OK

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

GET https://api.helium.io/v1/accounts/:address/hotspots

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.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch details for

Query Parameters

param	Type	Note
cursor (optional)	string	Cursor for the next page of hotspots to fetch

200: OK

The hotspot list for an account

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

OUIs for Account

GET https://api.helium.io/v1/accounts/:address/ouis

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.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch details for

Query Parameters

param	Type	Note
cursor (optional)	string	Cursor for the next page of OUIs to fetch

200: OK

The oui list for account 13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc

{
  "data": [
    {
      "subnets": [
        {
          "mask": 8388352,
          "base": 0
        }
      ],
      "owner": "13tyMLKRFYURNBQqLSqNJg9k41maP1A7Bh8QYxR13oWv7EnFooc",
      "oui": 1,
      "nonce": 0,
      "block": 762440,
      "addresses": [
        "112qB3YaH5bZkCnKA5uRH7tBtGNv2Y5B4smv1jsmvGUzgKT71QpE"
      ]
    }
  ]
}

Activity for Account

GET https://api.helium.io/v1/accounts/:address/activity

Fetches 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 paged. If a cursor field is present in the response, more results are available.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch activity for

200: OK

{
  "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": 1608735310,
      "start_epoch": 643939,
      "rewards": [
        {
          "type": "poc_witnesses",
          "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
          "amount": 256295305,
          "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
        }
      ],
      "height": 643984,
      "hash": "FQnpxKBulLblJqSMsbgGbmv8ZHmu_2z4XJIeYKJGuIo",
      "end_epoch": 643983
    },
    {
      "type": "rewards_v1",
      "time": 1608726763,
      "start_epoch": 643837,
      "rewards": [
        {
          "type": "poc_challengees",
          "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
          "amount": 16652034,
          "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
        }
      ],
      "height": 643871,
      "hash": "yaEqGXHWOtElgG2RpaTuop2cwFaRypPIaOtsd11hPeQ",
      "end_epoch": 643870
    },
    {
      "type": "rewards_v1",
      "time": 1608715628,
      "start_epoch": 643648,
      "rewards": [
        {
          "type": "poc_challengers",
          "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
          "amount": 8050332,
          "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
        },
        {
          "type": "poc_challengees",
          "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
          "amount": 45796610,
          "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
        }
      ],
      "height": 643687,
      "hash": "-I__6qbqiopjMd94Zi94ixO-vyqFMeZdn0t2TRiTEjc",
      "end_epoch": 643686
    },
    {
      "type": "rewards_v1",
      "time": 1608713272,
      "start_epoch": 643540,
      "rewards": [
        {
          "type": "poc_challengees",
          "gateway": "1182nyT3oXZPMztMSww4mzaaQXGXd5T7JwDfEth6obSCwwxxfsB",
          "amount": 15927309,
          "account": "13GCcF7oGb6waFBzYDMmydmXx4vNDUZGX4LE3QUh8eSBG53s5bx"
        }
      ],
      "height": 643647,
      "hash": "mRYgIcJW-HcraoJQ3M5xlywDrNqNlHeeX2klKsGRGok",
      "end_epoch": 643646
    },
    {
      "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
    }
  ]
}

Activity Counts for Account

GET https://api.helium.io/v1/accounts/:address/activity/count

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.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch counts for

Query Parameters

param	Type	Note
filter_types	string	Comma separated list of transasction types

200: OK

Fetch counts with filter_types=add_gateaway_v1,assert_location_v1 for account 13ENbEQPAvytjLnqavnbSAzurhGoCSNkGECMx7eHHDAfEaDird

{
    "data": {
        "add_gateway_v1": 5777,
        "assert_location_v1": 5878
    }
}

Elections for Account

GET https://api.helium.io/v1/accounts/:address/elections

Fetches elections that hotspots for the given account are elected in.

The results are paged. If a cursor field is present in the response, more results are available.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch activity for

200: OK

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

Challenges for Account

GET https://api.helium.io/v1/accounts/:address/challenges

Fetches challenges that hotspots owned by the given account are involved in as a challenger, challengee, or witness.

The results are paged. If a cursor field is present in the response, more results are available.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch activity for

200: OK

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

Pending Transactions for Account

GET https://api.helium.io/v1/accounts/:address/pending_transactions

Fetches the outstanding transactions for the given account. See Pending Transactions for details.The list of returned pending transactions is paged. If a cursor field is present more results are available.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch details for

Query Parameters

param	Type	Note
cursor (optional)	string	Cursor for the next page of transactions to fetch

200: OK

A single pending transaction for a given account

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

Rewards for an Account

GET https://api.helium.io/v1/accounts/:address/rewards

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.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch details for

Query Parameters

param	Type	Note
cursor (optional)	string	Cursor for the next page of transactions to fetch

200: OK

A single pending transaction for a given account

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

Reward Totals for an Account

GET https://api.helium.io/v1/accounts/:address/rewards/sum

Returns the total rewards for a given account in a given timeframe. Timestamps can be given in ISO 8601 format (e.g. 2020-08-27T00:00:00Z) or in relative time (e.g. -1 week, which when url esacped becomes -1%20week). When ommitted the current time is assumed.

The results can also be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed per hotspot and time for the account to make hotspot performance comparison possible. Valid bucket values include hour, day and week).

For example to get the last 7 days of rewards bucketed by day use the following path/parameters: ?min_time=-7%20day&bucket=day

The block that contains the max_time timestamp is excluded from the result.

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch details for

Query Parameters

param	Type	Note
min_time (required)	string	First time to include rewards for
max_time (required)	string	Last time to include rewards for
bucket (optional)	string	Bucket specifier

200: OK

Returns the total rewards over a given time range

{
  "data": {
    "max_time": "2020-08-29T00:00:00Z",
    "min_time": "2020-08-27T00:00:00Z",
    "sum": "176714898"
  }
}

Stats for Account

GET https://api.helium.io/v1/accounts/:address/stats

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).

Request
Response

Path Parameters

param	Type	Note
address (required)	string	Account B58 address to fetch stats for

200: OK

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