Metadata-Version: 2.1
Name: predict-eth
Version: 0.1.2
Summary: Predict ETH challenges
Project-URL: Homepage, https://github.com/oceanprotocol/predict-eth
Project-URL: Bug Tracker, https://github.com/oceanprotocol/predict-eth/issues
Author-email: Trent McConaghy <gtrent@gmail.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Requires-Dist: eth-brownie>=1.19.3
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: ocean-lib
Requires-Dist: pytest
Requires-Dist: web3>=5.28.0
Description-Content-Type: text/markdown

# Predict-ETH

This is a challenge to predict the price of ETH. With prize $$. It uses [ocean.py](https://github.com/oceanprotocol/ocean.py) library.

Predicting ETH accurately helps to make $ in trading ETH, yield farming or DeFi protocol development. And, you can sell your predictions as a datafeed, for others to do the same. 

Then the challenge is: how accurately can _you_ predict ETH? 

### Current challenge

- [Predict-ETH Round 5](challenges/main5.md) - predictions due Wed May 3, 2023. [Announcement](https://blog.oceanprotocol.com/predict-eth-4-dive-into-decentralized-data-355f2281509e)

### Future challenges

Competitions are monthly. Predictions are due the first Wednesday of the month. 

- Predict-ETH Round 6 - predictions due Wed Jun 7, 2023
- Predict-ETH Round 7 - predictions due Wed Jul 5, 2023
- ...

(We reserve the right to alter competitions that have not launched yet.)

### Example End-to-End Flows

These are example full submissions to the challenge. You can use any of them as a starting point.

- [Simple](examples/end-to-end_simple.md): To-the-point example, with simple input data (just ETH price) and simple model (linear dynamical model)
- [Model optimization](examples/end-to-end_optimized.md): Same as [Simple](examples/end-to-end_simple.md) with added optimization using cross-validation to select best hyperparameters.
- [Compare models](examples/end-to-end_compare-models.md): Build models that predict 1-12 hours ahead in one shot. Compare linear, SVM, RF, and NN models.

### Example Data Sources

These are examples of how to get data from various places. Each place has its own benefits.

Get ETH price data:
- [Via Binance direct](examples/get-ethdata-binance-direct.md) - most direct, but specific to Binance
- [Via ccxt + Binance](examples/get-ethdata-ccxt-binance.md) - unified API across 40 exchanges
- [Via Ocean + Binance](examples/get-ethdata-ocean-binance.md) - unified API across 500+ data & compute services
- [Via Ocean + TheGraph](examples/get-ethdata-ocean-thegraph.md) - like previous, but uses a GraphQL-shaped query

### Inspiration: ideas for data & modeling

Here are ideas to get even more accurate results.

- [More data sources](ideas/data-sources.md)
- [Modeling approaches](ideas/modeling.md)
- [Articles](ideas/articles.md) on predicting ETH, etc

### Inspiration from algorithmic trading 

Getting into the head of a trader might inspire you in predicting ETH.

To help with that, the [algorithmic trading flow README](ideas/algorithmic-trading-flow.md) does a walk-through of the "[Freqtrade](https://github.com/freqtrade/freqtrade)" open-source trading tool with a custom trading strategy. 

### Appendix: Past challenges

- [Predict-ETH Round 1](challenges/main1.md) - predictions due Oct 16, 2022. [Announcement](https://blog.oceanprotocol.com/ocean-protocol-announces-the-launch-of-the-eth-prediction-challenge-7b1f04cc820e)
- [Predict-ETH special: web3 ATL hackathon](challenges/hack1.md) - predictions due Nov 6, 2022
- [Predict-ETH Round 2](challenges/main2.md) - predictions due Dec 11, 2022. [Announcement](https://blog.oceanprotocol.com/ocean-protocol-challenge-predict-eth-price-2nd-edition-9400212a30db), [Winners](https://blog.oceanprotocol.com/introducing-the-winners-of-the-eth-price-prediction-data-challenge-edition-2-6acdccb9271)
- [Predict-ETH Round 3](challenges/main3.md) - predictions due Mon Feb 20, 2023. [Announcement](https://blog.oceanprotocol.com/ocean-protocol-launches-the-3rd-edition-of-predict-eth-ccb7e6a62bf7), [Winners](https://blog.oceanprotocol.com/introducing-the-winners-of-the-predict-eth-3-data-challenge-f4ed7fb8e467)
- [Predict-ETH Round 5](challenges/main5.md) - predictions due Wed May 3, 2023. [Announcement](https://blog.oceanprotocol.com/predict-eth-4-dive-into-decentralized-data-355f2281509e), [Winners](https://blog.oceanprotocol.com/here-are-the-winners-of-the-predict-eth-round-4-data-challenge-1672b36c0af9)

### Appendix: Predict-eth library

Predict-eth is a [library on pypi](https://pypi.org/project/predict-eth/).

To install: `pip3 install predict-eth`

To further develop it:
- [Developers flow](developers.md)
- [Release process](release-process.md)
