Skip to main content

Oracles Ocean REST API

List Oracle

Get a list of Oracles

Code Samples

Shell
curl https://ocean.defichain.com/v0/mainnet/oracles
JavaScript (@defichain/whale-api-client)
await api.oracles.list()
Response
{
"data": [
{
"id": "f7a00f517a0201e2517a422c5d2b2807868b2615f17d8fc9d8d2bd6baab905b7",
"ownerAddress": "df1q02jh2rkymd6ncl75ql3f267u3guja9nzqj2qmn",
"weightage": 10,
"priceFeeds": [
{
"token": "AAPL",
"currency": "USD"
},
{
"token": "AMD",
"currency": "USD"
},
{
"token": "AMZN",
"currency": "USD"
},
{
"token": "COIN",
"currency": "USD"
},
{
"token": "FB",
"currency": "USD"
},
{
"token": "GME",
"currency": "USD"
},
{
"token": "GOOGL",
"currency": "USD"
},
{
"token": "MSTR",
"currency": "USD"
},
{
"token": "NVDA",
"currency": "USD"
},
{
"token": "OTGLY",
"currency": "USD"
},
{
"token": "SQNXF",
"currency": "USD"
},
{
"token": "TSLA",
"currency": "USD"
},
{
"token": "TWTR",
"currency": "USD"
},
{
"token": "UBER",
"currency": "USD"
}
],
"block": {
"hash": "923fe2d3f5920163d2401095de5647ce25ee3463863fad04e76eec48719fb8a3",
"height": 1398516,
"medianTime": 1637921787,
"time": 1637921973
}
}
],
"page": {
"next": "508beb786a51a6dfab3013e777e7b46a213668a2175f535dbe7296fb27bf3656"
}
}
TypeScript Definitions
export interface Oracle {
id: string

weightage: number
ownerAddress: string
priceFeeds: Array<{
token: string
currency: string
}>

block: {
hash: string
height: number
time: number
medianTime: number
}
}

Get Oracle Price Feed

Get Price Feed for each Oracle by Price Ticker.

Code Samples

Shell
https://ocean.defichain.com/v0/mainnet/oracles/f7a00f517a0201e2517a422c5d2b2807868b2615f17d8fc9d8d2bd6baab905b7/AAPL-USD/feed
JavaScript (@defichain/whale-api-client)
await api.oracles.getPriceFeed('f7a00f517a0201e2517a422c5d2b2807868b2615f17d8fc9d8d2bd6baab905b7', 'AAPL', 'USD')
Response
{
"data": [
{
"id": "AAPL-USD-f7a00f517a0201e2517a422c5d2b2807868b2615f17d8fc9d8d2bd6baab905b7-2628b115639b31eb8ed9a71761de9c117e4044daf0c430597aeccccd838caa05",
"key": "AAPL-USD-f7a00f517a0201e2517a422c5d2b2807868b2615f17d8fc9d8d2bd6baab905b7",
"sort": "001619842628b115639b31eb8ed9a71761de9c117e4044daf0c430597aeccccd838caa05",
"amount": "175.74",
"currency": "USD",
"block": {
"hash": "ed2000856e1a1c5d6d2bf6f916896a7dc736a39005f755be43efae8122f87340",
"height": 1448324,
"medianTime": 1639459804,
"time": 1639459967
},
"oracleId": "f7a00f517a0201e2517a422c5d2b2807868b2615f17d8fc9d8d2bd6baab905b7",
"time": 1639459804,
"token": "AAPL",
"txid": "2628b115639b31eb8ed9a71761de9c117e4044daf0c430597aeccccd838caa05"
}
],
"page": {
"next": "001619842628b115639b31eb8ed9a71761de9c117e4044daf0c430597aeccccd838caa05"
}
}
TypeScript Definitions
export interface OraclePriceFeed {
id: string
key: string
sort: string

token: string
currency: string
oracleId: string
txid: string

time: number
amount: string

block: {
hash: string
height: number
time: number
medianTime: number
}
}