diff --git a/.gitbook/assets/predictoor/ai-dao.png b/.gitbook/assets/predictoor/ai-dao.png new file mode 100644 index 00000000..b64cca4c Binary files /dev/null and b/.gitbook/assets/predictoor/ai-dao.png differ diff --git a/.gitbook/assets/predictoor/details_on_predictoor.png b/.gitbook/assets/predictoor/details_on_predictoor.png new file mode 100644 index 00000000..2803e208 Binary files /dev/null and b/.gitbook/assets/predictoor/details_on_predictoor.png differ diff --git a/.gitbook/assets/predictoor/predictoor_behavior.png b/.gitbook/assets/predictoor/predictoor_behavior.png new file mode 100644 index 00000000..5851f63b Binary files /dev/null and b/.gitbook/assets/predictoor/predictoor_behavior.png differ diff --git a/.gitbook/assets/predictoor/predictoor_overview.png b/.gitbook/assets/predictoor/predictoor_overview.png new file mode 100644 index 00000000..0bf117c0 Binary files /dev/null and b/.gitbook/assets/predictoor/predictoor_overview.png differ diff --git a/.gitbook/assets/predictoor/predictoor_splash.png b/.gitbook/assets/predictoor/predictoor_splash.png new file mode 100644 index 00000000..4ee556d6 Binary files /dev/null and b/.gitbook/assets/predictoor/predictoor_splash.png differ diff --git a/.gitbook/assets/predictoor/predictoor_structure.png b/.gitbook/assets/predictoor/predictoor_structure.png new file mode 100644 index 00000000..ed5efc11 Binary files /dev/null and b/.gitbook/assets/predictoor/predictoor_structure.png differ diff --git a/.gitbook/assets/predictoor/predictoor_ui.png b/.gitbook/assets/predictoor/predictoor_ui.png new file mode 100644 index 00000000..6da57173 Binary files /dev/null and b/.gitbook/assets/predictoor/predictoor_ui.png differ diff --git a/.gitbook/assets/predictoor/progression_of_a_predictoor.png b/.gitbook/assets/predictoor/progression_of_a_predictoor.png new file mode 100644 index 00000000..8cf584b4 Binary files /dev/null and b/.gitbook/assets/predictoor/progression_of_a_predictoor.png differ diff --git a/.gitbook/assets/predictoor/progression_of_a_trader.png b/.gitbook/assets/predictoor/progression_of_a_trader.png new file mode 100644 index 00000000..94b877d7 Binary files /dev/null and b/.gitbook/assets/predictoor/progression_of_a_trader.png differ diff --git a/.gitbook/assets/predictoor/simulated_returns_btc_tusd.png b/.gitbook/assets/predictoor/simulated_returns_btc_tusd.png new file mode 100644 index 00000000..2da32930 Binary files /dev/null and b/.gitbook/assets/predictoor/simulated_returns_btc_tusd.png differ diff --git a/.gitbook/assets/predictoor/simulated_returns_btc_usdt.png b/.gitbook/assets/predictoor/simulated_returns_btc_usdt.png new file mode 100644 index 00000000..3b8a1717 Binary files /dev/null and b/.gitbook/assets/predictoor/simulated_returns_btc_usdt.png differ diff --git a/.gitbook/assets/predictoor/value_creation_loop.png b/.gitbook/assets/predictoor/value_creation_loop.png new file mode 100644 index 00000000..fd068113 Binary files /dev/null and b/.gitbook/assets/predictoor/value_creation_loop.png differ diff --git a/SUMMARY.md b/SUMMARY.md index 533836ad..ba409e62 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -115,6 +115,11 @@ * [Deploying Ocean Subgraph](infrastructure/deploying-ocean-subgraph.md) * [Deploying C2D](infrastructure/compute-to-data-minikube.md) * [C2D - Private Docker Registry](infrastructure/compute-to-data-docker-registry.md) +* [👀 Predictoor](predictoor/README.md) + * [Learn about Predictoor](predictoor/pdr-intro.md) + * [Architecture](predictoor/pdr-architecture.md) + * [Parameters](predictoor/pdr-parameters.md) + * [How to Earn](predictoor/pdr-earn.md) * [🤑 DeFi](defi/README.md) * [💰 Data Farming Rewards](rewards/README.md) * [Farming 101](rewards/df-intro.md) diff --git a/predictoor/README.md b/predictoor/README.md new file mode 100644 index 00000000..0fbe8e24 --- /dev/null +++ b/predictoor/README.md @@ -0,0 +1,49 @@ +--- +description: >- + "Tomorrow belongs to those who can hear it coming." — David Bowie +--- + +# Overview + +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** - Now, there is accountability. If accuracy goes up; the farmer gets stuck less. Now we have accountable prediction feeds not only for rain, but also for temperature, for wind, and for sea temperature; for road congestion and train delays; for prices of ETH and NVID; for 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.** + +## Roadmap +Predictoor's tesnet is live now and mainnet will rollout soon. Overall, it will happen in three phases: Testnet → Mainnet → Data Farming. +1. **LAUNCHED: Tue Sep 12, 2023 - Predictoor Testnet is ready for community.** This means Ocean Predictoor smart contracts, middleware, and frontend running on Oasis Sapphire testnet. +1. **NEXT: Tue Oct 3 [4w later] - Predictoor Mainnet is ready for community.** This is like testnet but tokens have real value. There will be bridges as appropriate.  +1. **Thu Nov 2 [4w 2d later] - Predictoor Data Farming starts counting.** There will be 37,000 OCEAN weekly rewards to incentivize predictoors. You can find more about it in [Data Farming Intro - What are Active Rewards?](../rewards/df-intro.md#what-are-active-rewards) + +## Introduction +Predictoor is composed of different actors, often referred to as: predictoors and traders. You will learn in the [Introduction To Predictoor](#introduction) a lot more about these actors, how they are structured in the system, and their behaviors. By the time you've completed reading this, you'll know what Epochs are, and have a better understand of what "t+1" means. + +## Architecture +After obtaining a broad overview of the system and it's actors, you should be ready to dive into [The Architecture of Predictoor](#architecture) and the repository. You'll become more exposed to the key building blocks and pdr-backend, the integration component for Predictoors and Traders. + +We anticipate Predictoor to extend beyond DeFi to other verticals like climate and agriculture. Predictoor agents may evolve into AI DAOs with emergent swarm-like behavior. This is the future. + +## Earning with Predictoor +Predictoor serves two groups of actors: Predictoors, and Traders. In this section, we'll explore [How to Earn with Predictoor](#earning-with-predictoor) and describe how both of these groups can benefit from it. After you are done with this, you should know what steps you need to take next in order to start leveraging the system for your own benefit. + +We'll also provide some links and exercise to make this easier for you. + +## Predictoor Parameters and Roadmap +[Predictoor Parameters](#predictoor-parameters) will provide such as incentives, feed costs, deployed feeds, and details about it's possible future. + +## Connect with Us +If you want to talk to other Predictoors, Traders, and contributors to this ecosystem, [Join us on Discord](https://discord.gg/TnXjkR5). + +## Predictoor Resources +These documents are a summary of many resources. +- Blog Post: ["Meet Predictoor: Accountable Accurate Prediction Feeds"](https://blog.oceanprotocol.com/meet-predictoor-accountable-accurate-prediction-feeds-8b104d26a5d9) +- Ocean meetup [[GSlides](https://docs.google.com/presentation/d/1Yj14l-FRaMOgxXflHV0-sdHEdAFaAuB2MJNovQEtRFE/edit)][[pdf](https://github.com/trentmc/slides/blob/main/20230913-ocean-meetup-predictoor.pdf)] +- Dappcon [[GSlides](https://docs.google.com/presentation/d/118tBnWNbzuq6vL1TITGq69RKPvHWbxVUZULp8KnfPyQ/edit#slide=id.g243aace1a9a_0_681)][[pdf](https://github.com/trentmc/slides/blob/main/20230912-dappcon-berlin-predictoor.pdf)] +- Core Repository `pdr-backend`: https://github.com/oceanprotocol/pdr-backend/ +- Frontend Repository `pdr-web`: https://github.com/oceanprotocol/pdr-web/ \ No newline at end of file diff --git a/predictoor/pdr-architecture.md b/predictoor/pdr-architecture.md new file mode 100644 index 00000000..4c27c158 --- /dev/null +++ b/predictoor/pdr-architecture.md @@ -0,0 +1,56 @@ +--- +description: >- + "We can only see a short distance ahead, but we can see plenty there that needs to be done." — Alan Turing +--- + +# Predictoor Architecture + +## 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 & Contract Details +The section ["Predictoor Structure”](pdr-intro.md#predictoor-structure) presented much of the Predictoor architecture. + +The image below adds detail around the backend (bottom 1/3 of diagram). Let’s discuss. + +
Details of Predictoor Structure (Architecture)
+ +**Smart Contracts.** There’s 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 [Ocean’s 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 you’ve 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. + +## 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. You can find the [Tutorial on How to Get tokens here](https://github.com/oceanprotocol/pdr-backend/blob/main/READMEs/testnet-faucet.md). + +**Fake OCEAN.** Staking & payment is in fake OCEAN. Users acquire it via a faucet. +**Fake ROSE.** Gas fees are in fake ROSE. Users acquire it via a faucet. + +## 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. Users [acquire OCEAN via exchanges](https://oceanprotocol.com/about-us/ocean-token#get). Users bridge OCEAN tokens from ETH mainnet to Oasis Sapphire mainnet via [Celer](https://celer.network/). +**ROSE.** Gas fees are in ROSE. Users bridge tokens bridge from Oasis Emerald mainnet to Oasis Sapphire mainnet via Celer. [Read the details here](https://oasisprotocol.org/blog/celer-messaging-bridge-integration) diff --git a/predictoor/pdr-earn.md b/predictoor/pdr-earn.md new file mode 100644 index 00000000..dc397d1a --- /dev/null +++ b/predictoor/pdr-earn.md @@ -0,0 +1,67 @@ +# How to Earn + +## How to Earn as a Predictoor +If you have background in AI, ML, data science or statistics (and these overlap!) then you’re well suited to become a predictoor to make \$. + +
+ +Typical steps as a Predictoor: +1. **Play with predictoor.ai.** Go to predictoor.ai to build intuition: observe the free feed, perhaps buy a few feeds, and watch them change over time. +1. **Do Challenge DF: one-off predictions.** Then, practice making accurate AI/ML based predictions via Challenge Data Farming. Submissions are due Wednesdays at midnight, for ETH price predictions 5 min, 10 min, …, 60 min ahead. Every week, 5000 OCEAN prize money is distributed to the three lowest-error submissions. +1. **Run a predictoor bot: continuous predictions.** Follow the steps in the Predictoor README. You’ll start by deploying a bot locally that submits a random prediction every 5 minutes. Then you’ll add AI/ML model predictions. Then you’ll do it on a remote testnet staking fake OCEAN. Finally, you’ll 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. It’s 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 DF.** The third phase of Predictoor rollout will have an incentives program that amounts to additional earning for predictoors. 37,000 OCEAN/week rewards. +Don’t expect to be 100% accurate in your up/down predictions. Marginally better than 50% might be enough, and be skeptical if you’re greatly above 50%, you probably have a bug in your testing. + +Predictoors can earn even more, via complementary actions: +* **[Challenge DF](../rewards/df-intro.md#what-is-challenge-df).** Predict accurately for weekly prizes. + +Every week there’s [150,000 total OCEAN rewards](../rewards/df-intro.md#reward-schedule) for Ocean Data Farming. This will increase in early 2024, and more yet later. + +⚠️ You will lose money as a predictoor if your \$ out exceeds your \$ in. If you have low accuracy you’ll 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. + +## 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. + +
+ +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). You’ll start by deploying a bot locally that follows the baseline trading strategy: when a new Predictoor prediction pops in, it buys if “↑”, and sells if “↓”. Then you’ll do it on a remote testnet with fake tokens. Finally, you’ll 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**. 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 you’re not active as a predictoor or a trader, you can earn nonetheless. + +* **[Passive DF](../rewards/df-intro.md#what-are-passive-rewards).** By simply locking your OCEAN for veOCEAN, you can earn passive rewards. +* **[Volume DF](../rewards/df-intro.md#what-are-active-rewards).** Point the veOCEAN to data assets with high data consume volume (DCV). Predictoor feeds are great candidates for high-DCV assets (Predictoor assets are a good choice). + +## 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/TUSD 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/TUSD is not very liquid; therefore larger amounts cause slippage. + +Simulated returns vs time of BTC/TUSD 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/TUSD. + +
Simulated returns vs time of BTC/USDT trading on Binance. Trade size has little impact.
diff --git a/predictoor/pdr-intro.md b/predictoor/pdr-intro.md new file mode 100644 index 00000000..87fe88f6 --- /dev/null +++ b/predictoor/pdr-intro.md @@ -0,0 +1,60 @@ +--- +description: >- + "Yesterday is gone. Tomorrow has not yet come. We have only today. Let us begin." - A mother +--- + +# Introduction + +**Ocean Predictoor is a stack and a dapp for prediction feeds.** It has accountability for accuracy, via staking. It’s 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 \$. + +
Conceptual overview of Predictoor
+ +**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 privacy-preserving EVM chain. + +**The initial dapp is live at [predictoor.ai](https://predictoor.ai).** It’s 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. + +
Screenshot from predictoor.ai
+ +## 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 \$. + +
Predictoor Structure
+ +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. + +
Predictoor Behavior
+ +**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*predval1 + stake2*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. + +*They might have also exited earlier if price spiked (“take profits” action) or price was crashing (“stop loss” action). + +- **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. + +*Submitting a “true” price value like this could also have been performed using a Chainlink setup (or otherwise). However we wanted to retain flexibility for feeds not currently on Chainlink, for now. \ No newline at end of file diff --git a/predictoor/pdr-parameters.md b/predictoor/pdr-parameters.md new file mode 100644 index 00000000..5a608e11 --- /dev/null +++ b/predictoor/pdr-parameters.md @@ -0,0 +1,35 @@ +# Predictoor Parameters + +## 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 mainnet, tentatively, there will be 20 feeds: +- 10x at 5m timescales like above +- 10x at 60m timescales like above + +## Pricing +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. + +## Predictoor Data Farming +[Ocean Data Farming](https://df.oceandao.org/rewards) (DF) is an incentives program currently with [150K OCEAN rewards](../rewards/df-intro.md#reward-schedule) per week. + +In Nov 2nd, a reward stream will be introduced to incentivize predictoors. This reward stream will provide 37,000 OCEAN in weekly rewards. You can find more about it in [Data Farming Intro - What are Active Rewards?](../rewards/df-intro.md#what-are-active-rewards) + +# Possible Futures +This first release of Predictoor is just the beginning. We anticipate adding many more crypto feeds: more coins, more exchanges (CEX and DEX), more timescales; and predictions beyond just coin prices. + +We envision the Predictoor stack being used in other verticals like real estate, weather, climate, transportation, and agriculture. We envision refinements of the core Predictoor technology. + +Predictoor’s predictions are the final step of the web3 data value creation pipeline, right before action is taken and \$ is made. We anticipate that the \$ made by Predictoors will filter upstream, into work to create feeds used by Predictoors, such as sentiment analysis, volatility, and information ticks. + +Most interestingly, the agents of the Predictoor ecosystem may evolve. Starting as relatively simple agents running on the centralized cloud, Predictoor’s incentives can drive them to becoming decentralized and autonomous, while performing AI. Yes, [AI DAOs](https://medium.com/@trentmc0/ai-daos-and-three-paths-to-get-there-cfa0a4cc37b8). Swarms of sovereign agents: some predicting, some trading, and some providing support services along the data supply chain. It will feel a bit like [nature](https://blog.oceanprotocol.com/nature-2-0-27bdf8238071), a bit [out of control](https://www.amazon.de/-/en/Kevin-Kelly/dp/0201483408), and wholly exciting! + +
Left: a swarm/agent-based AI DAO architecture. Right: book cover for Out of Control by Kevin Kelly +
\ No newline at end of file diff --git a/rewards/df-intro.md b/rewards/df-intro.md index 663ad035..eab367e2 100644 --- a/rewards/df-intro.md +++ b/rewards/df-intro.md @@ -52,6 +52,15 @@ Rewards are paid in OCEAN to contributors actively working to improve Ocean Prot | --------------- | -------------- | | 5,000 OCEAN | 70,000 OCEAN | +**November 2** will then change when Predictoor DF is launched: +1. 1,000 OCEAN is paid out to Challenge DF. +2. 37,000 OCEAN is paid out to Volume DF. +3. 37,000 OCEAN is paid out to PredictoorDF. + +| Challenge DF | Volume DF | Predictoor DF | +| --------------- | -------------- | -------------- | +| 1,000 OCEAN | 37,000 OCEAN | 37,000 OCEAN + ### What is Volume DF [Volume DF](df-volumedf.md#allocating-veocean) rewards Data Farmers that allocate their veOCEAN tokens to Ocean datasets. It's called Volume DF because the amount of rewards relies on assets that are actively generating Data Consume Volume. @@ -80,6 +89,10 @@ Challenge DF rewards Data Scientists that produce prediction models that consist You can visit the follow tutorial learn how to [access Challenge DF](../user-guides/data-farming/how-to-challengedf.md). +### What is Predictoor DF + +Predictoor DF rewards Data Scientists (as a predictoor) that submit continuous predictions for future price movements of different assets. It's called Predictoor DF because weekly rewards are dispensed towards predictoors that are competing to accurately predict asset prices. Therefore **Predictoor DF yields depend on participants being accuracte and outcompeting each other** + ### What's the difference between Data Farming and Yield Farming? If you are familiar with 'liquidity mining' then you will find Data Farming similar, but instead, tuned for the curation of high quality assets in the Ocean ecosystem. diff --git a/rewards/df-volumedf.md b/rewards/df-volumedf.md index 7b47569e..495ef044 100644 --- a/rewards/df-volumedf.md +++ b/rewards/df-volumedf.md @@ -22,13 +22,13 @@ Data Farming rewards farmers that allocate their veOCEAN tokens to assets that * Thus, if you really want to max out Volume DF APY: 1. Lock your OCEAN for 4 years to receive 100% voting power. 1. Have other participants delegate their Allocation Power to you. -1. Create & publish assets (and make $ in selling them) — or work with people who can. +1. Create & publish assets (and make \$ in selling them) — or work with people who can. 1. Point your Allocation Power towards your published assets to receive a 2x bonus. 1. Claim weekly Passive Rewards, Active Rewards, and update your lock. ### Success Metrics -**Data Consume Volume (DCV)** is our term for **the total $ amount spent on purchases of Ocean ecosystem assets**, transaction fees, and more. The higher DCV of Ocean ecosystem assets, then the more OCEAN rewards are distributed to Data Farmers. It's that simple! +**Data Consume Volume (DCV)** is our term for **the total \$ amount spent on purchases of Ocean ecosystem assets**, transaction fees, and more. The higher DCV of Ocean ecosystem assets, then the more OCEAN rewards are distributed to Data Farmers. It's that simple! ### Those assets don't sell themselves!