Fix #1426: [Pdr] Reconcile pdr-related docs with docs.predictoor.ai

This commit is contained in:
trentmc 2024-03-20 14:21:54 +01:00
parent 929212d257
commit 63736e4f84
23 changed files with 12 additions and 480 deletions

View File

@ -131,4 +131,10 @@ redirects:
rewards/user-guides/how-to-veocean: data-farming/README.md
rewards/user-guides/how-to-volumedf: data-farming/README.md
data-farming/challengedf: data-farming/README.md
data-farming/challengedf-guide: data-farming/README.md
data-farming/challengedf-guide: data-farming/README.md
predictoor/pdr-intro: predictoor/README.md
predictoor/pdr-architecture: predictoor/README.md
predictoor/pdr-earn: predictoor/README.md
predictoor/pdr-parameters: predictoor/README.md
predictoor/pdr-faq: predictoor/README.md
predictoor/pdr-resources: predictoor/README.md

Binary file not shown.

Before

Width:  |  Height:  |  Size: 802 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 260 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 356 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 210 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 206 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 171 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 79 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 376 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 108 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 108 KiB

View File

@ -115,12 +115,6 @@
- [Data Value-Creation Loop](data-scientists/the-data-value-creation-loop.md)
- [What data is valuable?](data-scientists/data-engineers.md)
* [👀 Predictoor](predictoor/README.md)
* [Introduction](predictoor/pdr-intro.md)
* [Architecture](predictoor/pdr-architecture.md)
* [How to Earn](predictoor/pdr-earn.md)
* [Parameters](predictoor/pdr-parameters.md)
* [Pdr FAQ](predictoor/pdr-faq.md)
* [Pdr Resources](predictoor/pdr-resources.md)
* [💰 Data Farming](data-farming/README.md)
* [Passive DF (and veOCEAN)](data-farming/passivedf.md)
* [Guide to Passive DF](data-farming/passivedf-guide.md)

View File

@ -12,7 +12,7 @@ In Predictoor DF (and Predictoor proper), you run prediction bots to earn contin
## How to become a predictoor
- Play with the dapp: http://predictoor.ai
- Then follow [Predictoor usage guide](../predictoor/pdr-earn.md)
- Then go through "How to earn as a Predictoor" in [Predictoor docs](https://docs.predictoor.ai)
- Or, go straight to the [quickstart README](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/predictoor.md) :) 🏎️
## On OCEAN Rewards in Predictoor DF

View File

@ -27,7 +27,7 @@ You should be familiar with both Predictoor and DF before reading on.
## Predictoor DF Timing
Predictoor DF starts counting on Nov 9, 23, at the beginning of Data Farming Round 63 (DF63). It runs indefinitely.
Predictoor DF started counting on Nov 9, 2023, at the beginning of Data Farming Round 63 (DF63). It runs indefinitely.
## Predictoor DF Rewards

View File

@ -1,38 +1,7 @@
---
description: Tomorrow belongs to those who can hear it coming. — David Bowie
cover: ../.gitbook/assets/cover/predictoor_banner.png
coverY: 0
description: Run AI-powered prediction bots or trading bots on crypto price feeds to earn $
---
# Summary
> **Run AI-powered prediction bots or trading bots on crypto price feeds to earn $.**
Ocean Predictoor provides on-chain "prediction feeds" on whether ETH, BTC, etc will rise in the next 5 min or 60 min. "**Predictoors**" submit predictions and stake on them; predictions are aggregated and sold to **traders** as alpha. Get started at [predictoor.ai](https://predictoor.ai).
<div align="center">
<figure><img src="../.gitbook/assets/predictoor/predictoor_ui_crop.png"></figure>
</div>
## Quick Links
- [Introduction](pdr-intro.md) - the "why" and "what"
- [Architecture](pdr-architecture.md) - structure, behavior, privacy
- [How to earn](pdr-earn.md) by running a trader or predictoor bot
- [Pdr-backend repo](https://github.com/oceanprotocol/pdr-backend) - how to run bots, specifically
- [Predictoor Data Farming](../data-farming/predictoordf.md) - baseline sales $ for running predictoor bots
- [Parameters](pdr-parameters.md) on price of feeds, more
- [FAQ](pdr-faq.md) and [further resources](pdr-resources.md)
Finally, join us on [**Discord**](https://discord.gg/TnXjkR5) to chat with other predictoors, traders, or devs in the Predictoor ecosystem.
----
_Next: [Introduction](pdr-intro.md)_
_Back: [Docs main](../README.md)_
<figure><img src="../.gitbook/assets/cover/predictoor_banner.png" alt=""></figure>
**Predictoor docs are now at [docs.predictoor.ai](https://docs.predictoor.ai).**

View File

@ -1,91 +0,0 @@
---
description: >-
"It was never easy to look into the future, but it is possible and we should not miss our chance." — Andrei Linde
---
# Predictoor Architecture
Contents:
- [Predictoor Structure](#predictoor-structure)
- [Predictoor Behavior](#predictoor-behavior)
- [Privacy & Oasis Sapphire](#privacy-and-oasis-sapphire)
- [Software Implementation](#software-implementation)
- [Backend & Contract Details](#backend-and-contract-details)
## Predictoor Structure
The image below gives an overview of Predictoor structure.
In the image top left, predictoors, traders, or anyone play with predictoor.ai to build an understanding how predictoor works. One feed is free; the rest are available for purchase. At first, only the free feed is visible. Users can connect their web3 wallet and buy another feed.
In the image top middle, predictoors graduate to building & deploying Python "Template Predictoor bots" (agents), which submit predictions every 5 minutes. Now, predictoors can see how to make revenue from making predictions, with plenty of room to improve AI/ML modeling accuracy and make more \$.
<figure><img src="../.gitbook/assets/predictoor/predictoor_structure.png" alt=""><figcaption>Predictoor Structure</figcaption></figure>
In the image top right, traders graduate from predictoor.ai to building & deploying Python "Template Trader bots" (agents), which grab the latest prediction every 5 minutes, as soon as it's available, then trade using that prediction (and other info). Now, Traders can see how to make \$ from buying predictions, with plenty of room to improve trading strategy and make more \$.
In the image bottom is the Oasis Sapphire chain, with Predictoor feed contracts deployed to it. There's one contract deployed for each {pair, exchange, timescale} such as {ETH/USDT, Binance, 5m}.
## Predictoor Behavior
We just covered Predictoor structure. Let's now layer on some Predictoor behavior, with the help of the image below. We'll walk through actions by Predictoors and Traders related to predictions for time slot "epoch t+1", and show how they make \$. 
We assume predictions on BTC, and where epoch t ends at 5:00pm, t+1 ends 5:05pm, and t+2 ends 5:10pm. We assume that Traders already purchased a subscription via predictoor.ai, Python, or otherwise. When we discuss an action by a Predictoor or Trader, we recognize that it's typically executed by their agent (bot).
**Epoch t.** This is left 1/3 of the image. It starts at 4:55pm and ends at 5:00pm. Predictoor 1 (pink) predicts that BTC close price for epoch t+1 will be higher ("↑") than close price for epoch t. He submits a tx to that chain with that prediction, and some OCEAN stake of his choice (higher stake = more confident). Predictoor 2 (dark green) does the same. Predictoor 3 (light green) predicts "↓" and stakes. The chain stores these prediction values, privately.
<figure><img src="../.gitbook/assets/predictoor/predictoor_behavior.png" alt=""><figcaption>Predictoor Behavior</figcaption></figure>
**Epoch t+1.** The middle 1/3 of the image covers epoch t+1. It starts at 5:00pm and ends at 5:05pm. The BTC Predictoor contract computes the aggregated predicted value (agg_predval) as stake-weighted sum across individual predictions.
> agg_predval = (stake1 x predval1 + stake2 x predval2 + …) / (stake1 + stake2 + …)
The contract then makes agg_predval visible to its subscribers. The predicted value is the stake-weighted sum across predictions. Smart traders may take the information and act immediately. A baseline strategy is "if it predicts ↑ then buy; if it predicts ↓ then sell or short".
**Epoch t+2.** This is the right 1/3 of the image. It starts at 5:05pm and ends at 5:10pm. Both traders and trueval agent take action (and, predictoors get paid).
- **Actions by Traders.** Typically, traders exit their position immediately, exactly 5 minutes since they got the 5-minute-ahead prediction and acted*. If the prediction feed was accurate enough and trading fees & slippage weren't too high, then the trader makes money on average.
- **Actions by Trueval agent; predictoors get paid.** The trueval agent is a process that grabs price feeds from e.g. Binance and submits it to chain, inside the smart contract*. The "submit" transaction also takes the opportunity to calculate each Predictoor's reward or slashing, and update their OCEAN holdings in the contract accordingly. (Funds aren't sent per se, they're made available via ERC20 "approve", for the predictoor to transfer at some later point). Predictoor 3 got his OCEAN slashed because he was wrong; predictoors 1 and 2 receive that as income, in addition to receiving income from prediction feed sales to traders. Predictoors can claim their balance anytime.
## Privacy and Oasis Sapphire
Predictoor needs privacy for:
- Submitted predictions
- Compute aggregate predictions; and
- Aggregated predictions — only subscribers can see
This could all be done on fully-centralized infrastructure. But doing so would fail on our other goals: **being globally distributed, censorship resistant, and non-custodial**.
Targeting these needs, we researched & prototyped many privacy technologies. [Oasis Sapphire](https://oasisprotocol.org/sapphire) emerged as the best choice because, as the only privacy-preserving EVM chain in production, it could handle these needs cleanly end-to-end.
## Software Implementation
Most of [predictoor.ai](https://predictoor.ai) dapp is implemented in the [pdr-web repo](https://github.com/oceanprotocol/pdr-web), with help from [pdr-websocket](https://github.com/oceanprotocol/pdr-websocket/) to fetch feed data and [Ocean Aquarius](https://github.com/oceanprotocol/aquarius) for metadata caching.
The template Predictoor bots, trader bots, trueval bot, and prediction feed publishing are all in the [pdr-backend repo](https://github.com/oceanprotocol/pdr-backend). Contracts are in the Ocean [contracts](https://github.com/oceanprotocol/contracts) repo.
Events emitted by contracts are indexed as Ocean subgraphs, to be consumed by predictoor.ai and the bots. The backend [subgraph README](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/subgraph.md) has more info.
## Backend and Contract Details
The section [Predictoor Structure](pdr-intro.md) presented much of the Predictoor architecture.
The image below adds detail around the backend (bottom 1/3 of diagram). Lets discuss.
<figure><img src="../.gitbook/assets/predictoor/details_on_predictoor.png" alt=""><figcaption>Details of Predictoor Structure (Architecture)</figcaption></figure>
**Smart Contracts.** Theres one Predictoor contract for each prediction feed, at each exchange/timescale: BTC/USDT at Binance/5m, ETH/USDT at Binance/5m, and so on. Each contract is an Ocean datatoken contract, with a new template for prediction feeds.
The implementation is in templates/ERC20Template3.sol at at [Oceans contracts repo](https://github.com/oceanprotocol/contracts). It implements ERC20, Ocean, and Predictoor-specific behavior as follows.
**- ERC20 behavior.** It implements the ERC20 interface and therefore plays well with ERC20-friendly crypto wallets, DEXes, etc.
**- Ocean behavior.** Being part of Ocean, having 1.0 datatokens means you can access the underlying data asset for the duration of the subscription (once youve initiated the order). For Predictoor contracts this is 24h. Each datatoken contract has a parent Ocean data NFT with metadata, means to specify & collect fees, and more.
**- Predictoor behavior.** Each datatoken contract has additional methods specific to Predictoor: submitting predictions, submitting truevals, computing aggregated predictions, etc.
----
_Next: [How to earn](pdr-earn.md)_
_Back: [Introduction](pdr-intro.md)_

View File

@ -1,76 +0,0 @@
# How to Earn
## How to Earn as a Predictoor
If you have background in AI, ML, data science or statistics (and these overlap!) then youre well suited to become a predictoor to make \$.
<figure><img src="../.gitbook/assets/predictoor/progression_of_a_predictoor.png" alt=""></figure>
Typical steps as a Predictoor:
1. **Play with predictoor.ai.** Go to [predictoor.ai](https://predictoor.ai) to build intuition: observe the free feed, perhaps buy a few feeds, and watch them change over time.
1. **Run a predictoor bot.** Follow the steps in the [Predictoor README](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/predictoor.md). Youll start by running simulations with AI-powered predictions. Then you'll run a predictoor bot on a remote testnet staking fake OCEAN. Finally, youll do it on mainnet staking real OCEAN.
1. **Optimize the bot.** Improve model prediction accuracy via more data and better algorithms. Extend to predict >1 prediction feeds (Predictoor has many). Wash, rinse, repeat.
The actions as a predictoor give the following ways to earn:
* **Feed sales.** At an epoch, sales revenue (minus fees) for that epoch goes to predictoors. Its distributed pro-rata by stake among the predictoors who predicted the true value correctly. The revenue for an epoch is the fraction of sales, spread uniformly across subscription length. A price of 3 OCEAN, 5m epochs, and 24h (1440m) subscriptions gives a revenue of (# subscribers) * (3 OCEAN) * / (1440m / 5m).
* **Stake reshuffling.** At an epoch, incorrect predictoors have their stake slashed. This slashed stake is distributed to the correct predictoors pro-rata on their stake.
* **Predictoor Data Farming.** This amounts to additional earning for predictoors. [Here are details.](../data-farming/predictoordf.md)
**On Prediction Accuracy.** Dont expect to be 100% accurate in your up/down predictions. Marginally better than 50% might be enough, and be skeptical if youre greatly above 50%, you probably have a bug in your testing.
**On Amount to Stake.** How much should a predictoor stake, to maximize revenue and bound risk? If you stake more, you can earn more, _but only to a point_. Earnings are bounded by sales of the feeds. So if you stake too much, you will lose $. [This blog post](https://blog.oceanprotocol.com/rewards-mechanisms-of-ocean-predictoor-6f76c942baf7) provides equations that bound how much to stake, along with general tips.
{% hint style="warning" %}
You will lose money as a predictoor if your \$ out exceeds your \$ in. If you have low accuracy youll have your stake slashed a lot. Do account for gas fees, compute costs, and more. Everything you do is your responsibility, at your discretion. None of this blog is financial advice.
{% endhint %}
## How to Earn as a Trader
You can make \$ by buying prediction feeds, and using it as an input — as “alpha” — to your trading approach.
<figure><img src="../.gitbook/assets/predictoor/progression_of_a_trader.png" alt=""></figure>
Typical steps as a Trader:
1. **Play with dapp, and trade.** First, go to [predictoor.ai](https://test.predictoor.ai/) to build intuition: observe the free feed, perhaps buy a few feeds, and watch them change over time. In a second window, have Binance open. Employ a baseline trading strategy: when a new Predictoor prediction pops in, buy if “↑”, and sell or short if “↓”; exit the position 5 min later.
1. **Run a trader bot.** Follow the steps in the [Trader README](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/trader.md). Youll start by running simulations with AI-powered predictions. It follows the baseline trading strategy: when a new Predictoor prediction pops in, it buys if “↑”, and sells if “↓”. Then youll do run a trader bot on a remote testnet with fake tokens. Finally, youll do it on mainnet with real tokens on a real exchange.
1. **Improve & extend.** Improve trading performance via more sophisticated trading strategies. This is a universe all of its own! Extend to >1 prediction feeds (Predictoor has many). Wash, rinse, repeat.
The actions as a trader offer a single yet powerful way to earn: **trading revenue.** Buy low and sell high! (And the opposite with shorting)
Traders can earn even more via a complementary action: **[Volume DF](../data-farming/volumedf.md).** Lock veOCEAN for OCEAN, then point the veOCEAN to data assets with high DCV. Predictoor feeds are great candidates for high-DCV assets.
⚠️ You will lose money trading if your \$ out exceeds your \$ in. Do account for trading fees, order book slippage, cost of prediction feeds, and more. Everything you do is your responsibility, at your discretion. None of this blog is financial advice.
## How to Earn as a Data Farmer
Even if youre not active as a predictoor or a trader, you can earn nonetheless.
* **[Passive DF](../data-farming/passivedf.md).** By simply locking your OCEAN for veOCEAN, you can earn passive rewards.
* **[Volume DF](../data-farming/volumedf.md).** Point the veOCEAN to data assets with high data consume volume (DCV). Predictoor feeds are great candidates for high-DCV assets.
## Early Earnings Benchmarks
Predictoor aims to make it easy for people to make \$ doing predictions (as predictoors), and taking actions against those predictions (as traders).
Before we started building Predictoor, we first asked: _can we predict ETH (etc) up/down with accuracy?_ Then we conducted intensive AI/ML research towards this question. The results of this investigation were positive 😎. TBH, we were surprised at the degree of market inefficiency.
Our next question was: _with these predictions, can we make \$ trading?_ Again, we conducted intensive AI/ML research, and again found positive results 😎😎.
Here we share some results of that research — a glimpse of how deep the rabbit hole goes — to inspire would-be predictoors and traders in their own work. The model was trained on data from January 1, 2021 to June 30, 2023, with simulated results the first 24 days of July 2023. A “baseline” trading strategy was used:
The image below shows simulated returns as a function of order size, for BTC/USDT on Binance. Duration = 7000 ticks x 5m/tick = 24.3 days of trading. It simulates spread effects. It assumes 0% fees. Note how the size of the order affects the return. This is because BTC/USDT is not very liquid; therefore larger amounts cause slippage.
Simulated returns vs time of BTC/USDT trading on Binance. Trade size has an impact.
The image below has the same experimental setup, but for BTC/USDT pair. The size of the order does not affect the return, because BTC/USDT is more liquid than BTC/USDT.
<figure><img src="../.gitbook/assets/predictoor/simulated_returns_btc_usdt.png" alt=""><figcaption>Simulated returns vs time of BTC/USDT trading on Binance. Trade size has little impact.</figcaption></figure>
----
_Next: [Parameters](pdr-parameters.md)_
_Back: [Architecture](pdr-architecture.md)_
_Or, drill into earning further:_
- [Pdr-backend repo](https://github.com/oceanprotocol/pdr-backend) - how to run bots, specifically
- [Predictoor Data Farming](../data-farming/predictoordf.md) - baseline sales $ for running predictoor bots

View File

@ -1,166 +0,0 @@
---
title: Predictoor FAQ
description: Frequently Asked Questions about Predictoor
---
## Predictoor FAQ
### Getting Started
<details>
<summary>How can users begin experimenting with Predictoor?</summary>
You can start by playing with [predictoor.ai](https://predictoor.ai), then click "run bots" and go through [Predictoor](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/predictoor.md) or [Trader](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/trader.md) README. This [blog](https://blog.oceanprotocol.com/meet-predictoor-accountable-accurate-prediction-feeds-8b104d26a5d9#048b) "How to Earn" section has details.
</details>
### For Predictoors
<details>
<summary>What happens if your prediction is good or bad?</summary>
If the prediction is wrong, your staked amount on that prediction is going to be slashed and distributed among people who submitted the right predictions.
</details>
<details>
<summary>Is it possible to predict without using bots?</summary>
Before we answer, please understand that to make decent money, it will take hundreds or thousands of submissions, guided by AI/ML models. So doing this manually would be tedious and error-prone. Therefore a bot is the most practical way. This is why the Predictoor core team has made it easy to run a bot. Here are the getting-started READMEs [Predictoor](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/predictoor.md) and [Trader](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/trader.md), respectively.
To the question "Is it possible to predict without a bot", the specific answer is "Yes". Here are the details
- Somehow you need to submit an up/down prediction, with OCEAN stake, as a transaction to Sapphire chain. Here are the Possible ways to do such a transaction:
- (a) Core team-supplied Python bot
- (b) simple Python script
- (c) Use "Write Contract" in [Sapphire blockchain explorer](https://explorer.sapphire.oasis.io)
- (d) 3rd-party bot that decides to support this
- (e) dapp that decides to support this
</details>
### For Traders
<details>
<summary>How can I trust individual predictions?</summary>
The most important metric to assess confidence in a prediction is "how much OCEAN have people *staked* on this prediction", both up and down. It's how much they're willing to lose if they're wrong. This metric is not gameable because OCEAN has scarcity. It's "put your money where your mouth is".
</details>
<details>
<summary>What factors influence the accuracy of Predictoor? How accurate do you think the predictions will be over time?</summary>
That's up to Predictoors to figure out! Certainly, historical price information has a huge influence. After that, there are many possibilities: other CEX and DEX data, on-chain data, social media data, GitHub data, news, weather, and more. The [Predictoor README](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/predictoor.md) gets you started, using historical price information.
</details>
### Price and Rewards
<details>
<summary>How is the pricing determined and will it continue to be 3 OCEAN?</summary>
Pricing is 3 OCEAN for one feed for 24 hours. It will be like that for the near-term future. We can expect price changes and price structure over time, as the Predictoor core team learns what pricing makes sense.
</details>
<details>
<summary>How do Predictoors benefit from sales? Is there a burn mechanism?</summary>
20% of prediction feed sales go to OPF. A portion of that is passed on to the Ocean community, including burning.
</details>
<details>
<summary>How Is Predictoor related to Data Farming?</summary>
Predictoor is its own dapp, stack, and set of feeds. In addition, the Ocean Data Farming infrastructure is extended to incentivize for activities within Predictoor.
Starting Nov 9, 2023 via "Predictoor Data Farming", there is 37000 OCEAN (about $10K) and several $K worth of ROSE allocated weekly to Predictoor DF. This will be used to purchase prediction feeds, alongside purchases by traders, etc. 80% of prediction feed sales goes to predictoors themselves.
</details>
### How is Predictoor different
<details>
<summary>How does Predictoor compare to prediction markets? Like Predictoor, they use $ for accountability.</summary>
Prediction markets are for one-off predictions like “will Biden win in 2024?” whereas Predictoor-style prediction feeds are for a continuous stream of predictions.
</details>
<details>
<summary>How does Predictoor compare to Chainlink? Like Predictoor, it has price feeds on-chain.</summary>
Chainlink provides current prices on-chain, and Predictoor makes predictions for prices in the future.
</details>
<details>
<summary>How does Predictoor compare to Numerai? Like Predictoor, it crowd-sources predictions, related to trading.</summary>
They are different:
- Numerai takes predictions, then aggregates them and uses them to trade directly. It operates as a hedge fund.
- Whereas Predictoor takes predictions, then aggregates them and sells the aggregate. It operates as data feeds.
Secondary differences:
- Numerai focus is tradfi trading, as a hedge fund.
- Whereas Predictoor is pure datafeeds, and applies to any vertical. Its first use case is defi trading.
- Currently Numerai is mostly centralized.
- Whereas Predictoor is decentralized. Predictoor tech may be useful to Numerai to help decentralize
</details>
<details>
<summary>How does Predictoor compare to Numerai Signals? People supplying to Numerai Signals dont get paid out from trading (like the main Numerai product).</summary>
In Numerai Signals, payout is a function of the submitters “originality” compared to other signals. These signals are used as inputs for prediction models in Numerai main product.
Whereas in Predictoor, payout is a function of the the accuracy of the submitters prediction, compared to the true value. These signals are predictions, directly.
</details>
<details>
<summary>How does Predictoor compare to IntoTheBlock Price Predictions tool? Is has prediction feeds of crypto prices.</summary>
The IntoTheBlock tool is run internally by IntoTheBlock, to build build centralized AI models that are served up via a REST API and a webapp.
You can view Predictoor as a "next-gen" version of that tool: a decentralized version that crowd-sources predictions.
- Crowd-sourcing with accuracy incentives has potential to do much better than any centralized approach. It doesn't rely on the ideas of a single team; instead it makes the opportunity to predict open to anyone in the world. A perpetual data-science competition. The incentives mean that only the best will stick around. This will get reflected in the prediction feeds' accuracies.
- Being decentralized means one doesn't need to rely on a centralized actor running centralized services. Useful for anyone coming to rely on prediction feeds.
Finally, Predictoor's ambition is broader: to extend beyond crypto into energy, weather, agriculture and more. It's easier to expand scope of decentralized feeds, because you don't need to spin up a new team to focus on each new vertical.
</details>
### Networks
<details>
<summary>Will Predictoor become available on other blockchain networks in the future?</summary>
Predictoor needs to leverage a privacy-preserving EVM chain which is in production. Oasis Sapphire is currently the only such chain.
</details>
----
_Next: [Further Resources](pdr-resources.md)_
_Back: [Parameters](pdr-parameters.md)_

View File

@ -1,40 +0,0 @@
---
description: >-
"Yesterday is gone. Tomorrow has not yet come. We have only today. Let us begin." - A mother
---
# Motivation: Why Predictoor?
[Prediction is intelligence](https://www.explainablestartup.com/2017/06/why-prediction-is-the-essence-of-intelligence.html), artificial or otherwise. We dream of a world of 10,000 truly accurate prediction feeds, for everything from rain forecasts to sea level rise, or traffic congestion to ETH price. [Ocean Predictoor](https://predictoor.ai/) is an on-chain, privacy-enabled, AI-powered application and stack that is bringing this dream to reality.
**Accurate predictions are valuable.** With them, one can take action and create value. Conversely, inaccurate predictions lead to disaster. Predictions have value because they're the [final step in a data supply chain](https://blog.oceanprotocol.com/the-data-value-creation-loop-68e23575be02), right before action is taken by the user.
**Prediction feeds** are a stream of predictions for a given time series. This could be predicting the price of ETH every 5 minutes, or the sea temperature daily. A feed may be binary, i.e. whether a time series changes up or down: ↑↓↓↓↑↓↑↑. Accurate prediction feeds are valuable.
Alas, accurate predictions are *hard*. Worse, typical prediction feeds have no accountability on accuracy. If the weatherman says "no rain for today" and then it rains, a farmer could get stuck in the mud, wrecking a portion of his crops. The weatherman doesn't feel the impact of wrong predictions, but the farmers sure care! 
**Accountable Predictions** - Imagine if there was accountability. Accuracy would go up; the farmer would be stuck less. Imagine accountable prediction feeds for not only for rain, but also wind, sea temperature, road congestion, train delays, ETH prices, NVID prices, housing prices, and more. **Imagine tens of thousands of prediction feeds with accountable accuracy.** Imagine them **globally distributed**, and censorship resistant. Imagine **accuracy improving with time**.
# What's Predictoor?
**Ocean Predictoor is a stack and a dapp for prediction feeds.** It has accountability for accuracy, via staking. Its globally distributed and censorship-resistant, by being on-chain. We expect its accuracy to improve over time, due to its incentive structure. Its first use case is DeFi token prediction because users can [close the data value-creation loop](https://blog.oceanprotocol.com/the-data-value-creation-loop-68e23575be02) quickly to make tangible \$.
<figure><img src="../.gitbook/assets/predictoor/predictoor_overview.png" alt=""><figcaption>Conceptual overview of Predictoor</figcaption></figure>
**Prediction feeds are crowd-sourced. "Predictoor" agents submit individual predictions and stake on them.** They make money when they're correct and lose money when not. This drives accurate prediction feeds, because only accurate predictoors will be making \$ and sticking around.
**“Trader” agents buy aggregate predictions,** then use them to take action like buying or selling. The more accurate the predictions, the more easily they make \$, the longer they stick around to keep buying prediction feeds from trading profits.
**Predictoor is built on the Ocean Protocol stack**, including contracts for tokenized data and middleware to cache metadata. To keep predictions private unless paid for, Predictoor uses **[Oasis Sapphire](https://oasisprotocol.org/sapphire)** privacy-preserving EVM chain.
**The initial dapp is live at [predictoor.ai](https://predictoor.ai).** Its for up/down predictions of BTC, ETH, and other tokens prices. The dapp helps users build a mental model of Predictoor behavior. Predictoors and traders main workflow is to do run predicting / trading bots with the help of the Py SDK. We have seeded Predictoor with bots that have AI/ML models of accuracy comfortably above 50% — a precondition to make \$ trading.
<figure><img src="../.gitbook/assets/predictoor/predictoor_ui.png" alt=""><figcaption>Screenshot from predictoor.ai</figcaption></figure>
----
_Next: [Architecture](pdr-architecture.md)_
_Back: [Predictoor Docs main](README.md)_

View File

@ -1,40 +0,0 @@
# Predictoor Parameters
## Testnet Details
As of Sep 12, 2023, Predictoor / Ocean contracts are deployed to [Oasis Sapphire testnet](https://docs.oasis.io/dapp/sapphire/#testnet).
Users need fake OCEAN & ROSE tokens:
**- Fake OCEAN.** Staking & payment is in fake OCEAN. Users acquire it via a faucet. [Here's how](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md).
**- Fake ROSE.** Gas fees are in fake ROSE. Users acquire it via a faucet. [Here's how](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md).
## Mainnet Details
As of Oct 10, 2023, Predictoor / Ocean contracts are deployed to [Oasis Sapphire mainnet](https://docs.oasis.io/dapp/sapphire/#mainnet).
Users need (real) OCEAN & ROSE tokens:
**- OCEAN.** Staking & payment is in OCEAN. [How to get OCEAN on Sapphire](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/get-ocean-on-sapphire.md).
**- ROSE.** Gas fees are in ROSE. [How to get ROSE on Sapphire](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/get-ocean-on-sapphire.md).
## Feeds Published
For testnet, there are 10 feeds: X/USDT pair for each of the top-10 coins by market cap (ignoring stablecoins), 5m timescales, on Binance, >0% fees on Binance. Paid feeds. The coins are: X = BTC, ETH, BNB, XRP, ADA, DOGE, SOL, LTC, TRX, DOT
For both testnet and mainnet, there are 20 feeds:
- X/USDT pair for each of the top-10 coins by market cap (ignoring stablecoins), on Binance, 5m timescales, on Binance. The coins are: X = BTC, ETH, BNB, XRP, ADA, DOGE, SOL, LTC, TRX, DOT
- Like above, but for 60m timescales
## Pricing
For each timescale, one feed is free: BTC/UTD on Binance. Below is pricing for the remaining feeds.
The price to subscribe to one feed for 24 hours is 3.00 OCEAN. This includes all fees. Fee details:
- 0.1% community swap fee
- 20% fee to Ocean Protocol Foundation. (Will be used to further drive Predictoor, and to burn OCEAN.)
- For reference, price without fees is 2.49791840133 OCEAN. To calculate this: Let x = price without fees. Then x * (1 + 0.20 + 0.001) = 3.0 → x = 3.0 / (1 + 0.20 + 0.001) = 2.49791840133
Pricing is subject to change based on learnings, and feedback from community.
----
_Next: [FAQ](pdr-faq.md)_
_Back: [How to earn](pdr-earn.md)_

View File

@ -1,24 +0,0 @@
# Further Resources on Predictoor
Main:
- Mainnet webapp: [predictoor.ai](https://predictoor.ai). Testnet: [test.predictoor.ai](https://test.predictoor.ai)
- Run bots via [pdr-backend](https://github.com/oceanprotocol/pdr-backend) repo
Intro:
- While _these docs_ are the best starting point to learn about Predictoor, here are some other useful sources.
- Original blogpost "Meet Predictoor", Sep 12, 2023 [[Link](https://blog.oceanprotocol.com/meet-predictoor-accountable-accurate-prediction-feeds-8b104d26a5d9)]
- Original talk "Introducing Prediction Feeds", Dappcon, Sep 12, 2023 [[Video](https://www.youtube.com/live/ev76qrunCn4?si=a6dw_qCgw3F3070y&t=24393)][[GSlides](https://docs.google.com/presentation/d/118tBnWNbzuq6vL1TITGq69RKPvHWbxVUZULp8KnfPyQ/edit#slide=id.g243aace1a9a_0_681)][[PDF](https://drive.google.com/drive/folders/1ekNmB1LcS81xfJ6ntZpzibi3PF6QFwFR)]
For thoroughness:
- All blog posts & media: ["Ocean Predictoor Series"](https://blog.oceanprotocol.com/ocean-predictoor-series-6a9122754a4d)
- Webapp code is at [pdr-web](https://github.com/oceanprotocol/pdr-web/) repo
----
Congrats, you've gone through all the Predictoor docs!
_Next: Go earn! Start at [how to earn](pdr-earn.md). Or, go to [Predictoor docs homepage](README.md)_
_Back: [FAQ](pdr-faq.md)_