Oracle Price Reports

An API endpoint that returns current and historical HNT Oracle Prices

get
Get historical HNT Oracle prices by block

https://api.helium.io/v1/oracle/prices
Returns up to 100 HNT prices along with the block in which they changed. It also returns a cursor to page through the results if needed. To get the price in $USD, divide the price field in the response by 100,000,000. For example, the price from block 370580 in the response below would be $0.29145000.
Request
Response
Request
Response
200: OK
A successful oracle price history query
"data": [
{
"price": 29145000,
"block": 370580
},
{
"price": 29427500,
"block": 370510
},
{
"price": 29837500,
"block": 370500
},
{
"price": 30000000,
"block": 369680
},
],
"cursor": "eyJiZWZvcmUiOjM2NzIzMH0"
}

get
Get Current HNT Oracle Price

https://api.helium.io/v1/oracle/prices/current
Returns the most recent HNT Oracle price, along with the block in which it was updated. To get the price in $USD, divide the price field in the response by 100,000,000. For example, the price from the response below is $0.29145000
Request
Response
Request
Response
200: OK
A successful current HNT price oracle query
{
"data": {
"price": 29145000,
"block": 370580
}
}

get
List Oracle activity

htps://api.helium.io/v1/oracle/activity
List oracle price report transactions for all oracle keys. This route is paged with a cursor.
Request
Response
Request
Query Parameters
cursor
optional
string
Cursor for the next page to fetch
Response
200: OK
{
"cursor": "eyJ0eXBlcyI6InByaWNlX29yYWNsZV92MSIsImJsb2NrIjozNzc5MDAsImFuY2hvcl9ibG9jayI6Mzc3OTAwfQ",
"data": [
{
"block_height": 377896,
"fee": 0,
"hash": "UcKE8X9UtuhOx5N3yxjyI7QcVihSoJTBq_DVQME7RWI",
"height": 377900,
"price": 35736000,
"public_key": "13Btezbvbwr9LhKmDQLgBnJUgjhZighEjNPLeu79dqBbmXRwoWm",
"time": 1592484227,
"type": "price_oracle_v1"
}
]
}

get
List activity for one Oracle

https://api.helium.io/v1/:address/activity
Lists price report transactions for the given oracle key. This route is paged using a cursor.
Request
Response
Request
Path Parameters
address
optional
string
The public key of the oracle
Query Parameters
cursor
optional
string
Cursor for the next page to fetch
Response
200: OK
{
"cursor": "eyJ0eXBlcyI6InByaWNlX29yYWNsZV92MSIsImJsb2NrIjozNzc5MDAsImFuY2hvcl9ibG9jayI6Mzc3OTAwfQ",
"data": [
{
"block_height": 377896,
"fee": 0,
"hash": "UcKE8X9UtuhOx5N3yxjyI7QcVihSoJTBq_DVQME7RWI",
"height": 377900,
"price": 35736000,
"public_key": "13Btezbvbwr9LhKmDQLgBnJUgjhZighEjNPLeu79dqBbmXRwoWm",
"time": 1592484227,
"type": "price_oracle_v1"
}
]
}