Oracle Prices

An API endpoint that returns current and historical HNT Oracle Prices

get
Current Oracle Price

https://api.helium.io/v1/oracle/prices/current
The current Oracle Price and at which block it took effect.
Request
Response
Request
Path Parameters
cursor
optional
string
Returned from an initial query, allowing client to fetch more results
Response
200: OK
The current Oracle Price and at which block it took effect.
{
"data": {
"price": 167000000,
"block": 471570
}
}

get
Current and Historical Oracle Prices

https://api.helium.io/v1/oracle/prices
The current and historical Oracle Prices and at which block they took effect. This route is paged using a cursor.
Request
Response
Request
Path Parameters
cursor
optional
string
Returned from an initial query, allowing client to fetch more results
Response
200: OK
Returns a list of recent Oracle Prices and at which block they took effect.
{
"data": [
{
"price": 167000000,
"block": 471570
},
{
"price": 169630000,
"block": 471540
}
],
"cursor": "eyJiZWZvcmUiOjQ2NjE5MH0"
}

get
Oracle Price at a Specific Block

https://api.helium.io/v1/oracle/prices/:block
Provides the oracle price at a specific block and at which block it initially took effect.
Request
Response
Request
Path Parameters
block
required
string
The block to get the HNT Oracle Price at
Response
200: OK
Returns a list of recent Oracle Prices and at which block they took effect.
{
"data": {
"price": 167000000,
"block": 471570
}
}

get
List Oracle Activity

https://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 a Specific Oracle

https://api.helium.io/v1/oracle/: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"
}
]
}

get
Get Predicted HNT Oracle Prices

https://api.helium.io/v1/oracle/predictions
This returns a list of expected times when the Oracle Price is expected to change.The blockchain operates in "block-time", meaning that blocks can come out at some schedule close to 1 per minute. Oracles report in "wall-clock-time", meaning they report what they believe the price should be.If the route returns one or more prices and times, it indicates that the chain is expected to adjust the price (based on Oracle reports) no earlier than the indicated time to the returned price.NOTE: A prediction may not be seen in the blockchain if they are close together (within 10 blocks) since block times may cause the blockchain to skip to a next predicted price. If no predictions are returned the current HNT Oracle Price is valid for at least 1 hour.
Request
Response
Request
Path Parameters
optional
string
‚Äč
Response
200: OK
Returns a prediction that the price will change to 47000000 at the earliest at the indicated seconds since Unix epoch time.
{
"data": [
{
"price": 47000000,
"time": 1594410146
}
]
}