Oracle Prices
An API endpoint that returns current and historical HNT Oracle Prices
getCurrent Oracle Price
get
https://api.helium.io/v1/oracle/prices/current
The current Oracle Price and at which block it took effect.
Request
Response
Request
​
Response
200: OK
The current Oracle Price and at which block it took effect.
{"data": {"price": 167000000,"block": 471570}}
getCurrent and Historical Oracle Prices
get
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"}
getOracle Price at a Specific Block
get
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}}
getList Oracle Activity
get
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"}]}
getList Activity for a Specific Oracle
get
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"}]}
getGet Predicted HNT Oracle Prices
get
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}]}
1
Last updated 4 months ago