Oracles

Provide is the easy button for consuming real-world data which has been oracalized on-chain (i.e., written to a smart contract) after consensus has been reached by a set of independently-operated nodes (oracles).

Provide supports Chainlink decentralized oracle networks which consist of security-reviewed, sybil-resistant and fully-independent nodes which are operated by leading blockchain devops and security teams.

Supported Use-Cases

Oracle Use-Case	Supported?	Resources
ETH Price	yes	Docs
Fiat Price	yes	Docs
Gas Price	yes	Docs
IoT Data	no - coming soon	-
Weather Data	no - coming soon	-

Additional use-cases will be supported incrementally based on demand. Please contact us if you have specific requirements.

List Oracles

List Oracles

GET https://nchain.provide.services/api/v1/oracles

Returns a list of oracle providers

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

200: OK

Documentation forthcoming.

Create Oracle

Create Oracle

POST https://nchain.provide.services/api/v1/oracles

Creates an oracle using the given parameters

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

Request Body

Name	Type	Description
description	string	brief description of oracle to be created
name	string	name of oracle to be created
network_id	string	id of network to host oracle

201: Created

Documentation forthcoming.

Retrieve Oracle Details

Get Oracle Details

GET https://nchain.provide.services/api/v1/oracles/:id

Returns detailed information about a specified oracle

Path Parameters

Name	Type	Description
id	string	id of target oracle

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

200: OK

{
    "id": "9645610d-9dca-45b2-bd3c-9fcaaedec122",
    "name": "Sample oracle",
    "description": "A sample oracle",
    "network_id": "07102258-5e49-480e-86af-6d0c3260827d"
}

Documentation forthcoming.

Update Oracle

Update Oracle

PUT https://nchain.provide.services/api/v1/oracles/:id

Updates a specified oracle

Path Parameters

Name	Type	Description
id	string	id of oracle to be updated

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

Request Body

Name	Type	Description
description	string	description of oracle to be updated
name	string	name of oracle to be updated
network_id	string	id of oracle host network to be updated

204: No Content

Documentation forthcoming.

Delete Oracle

Delete Oracle

DELETE https://nchain.provide.services/api/v1/oracles/:id

Deletes a specified oracle

Path Parameters

Name	Type	Description
id	string	id of oracle to be deleted

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

200: OK

Documentation forthcoming.