Fetch Data Specifications

This repository contains specifications of data requested from, reported to, and retrieved from Fetch oracles. Each specification is called a Query.

• For Fetch Users
• For Fetch Reporters
• Create new Query type

For Fetch Users:

Price data:

First check if the price data is already being reported here. If it is not, please fill this out.

Need a spot price from Fetch? Generate a unique identifier, or query ID, for the asset/currency pair using this tool. After, use that ID to pay reporters to put that data on-chain. Then retrieve the reported spot price from the oracle like this.

Custom data:

First, check in /types if there's already a query type that defines the data you need.

If not, create a new query type, pay reporters to put that data on-chain, and retrieve that data from a Fetch oracle like this.

For Fetch Reporters:

To find out what data to report, there's two options:

• Use our reporter client to automatically report the expected response of queries that Fetch users are funding.
• Check for newly funded queries, then refer to that query's expected response in /types for the required data to report. Be sure to read the dispute considerations section for that query.

Create New Query Type

To create a new Query, or specification, for custom data you need from Fetch oracles, there's two options:

• Make an issue with this template and the Fetch team will help with the next steps.

After creating the new query type in this repo, here are some next steps for getting reporters to support your data.

Contribute

Help us with issues here on Github, or feel free to reach out anytime [email protected].

Maintainers

This repository is maintained by the Fetch team.

Copyright

Fetch Inc. 2024