index and prediction markets (#595)

docs/index.md

@@ -1 +1,18 @@
 # Welcome to Prediction Market Agent Tooling
+
+Prediction Market Agent Tooling is a comprehensive suite designed to facilitate the benchmarking, deployment, and monitoring of agents within prediction market applications. This tooling is particularly useful for developers and researchers who are interested in creating and managing agents that interact with various prediction market platforms.
+
+## Core Capabilities
+
+- Benchmarking
+- Monitoring
+- Support for multiple prediction markets
+- Python APIs with clean abstractions
+
+## Key Features
+- Fully customizable agents (create your own strategies,custom functions, etc)
+- Social capabilities (Post on X)
+- Simple Cloud deployment
+- Ability to use various AI modesl (OpenAI,Anthropic,etc.)
+- Local tests
+

docs/predictionmarkets.md

@@ -0,0 +1,41 @@
+# What are Prediction markets?
+
+Prediction markets are decentralized platforms that allow participants to speculate on the outcomes of future events by trading tokens or assets tied to specific events. It leverages blockchain technology and smart contracts to create transparent, trustless, and immutable environments for this type of speculation.
+
+![](/docs/images/predictionmarket.png)
+## Key Components of Prediction Markets in Web3
+
+- Event-Based Contracts:
+Prediction markets are structured around specific events or outcomes, such as "Will Ethereum's price exceed $2,000 by March 2025?" Participants buy and sell shares representing potential outcomes.
+
+- Smart Contracts:
+These automated contracts execute and enforce the rules of the market, such as settling outcomes and distributing payouts. Smart contracts ensure trustlessness by eliminating the need for intermediaries.
+
+- Tokenized Shares:
+Each possible outcome is represented by a tradable token. For example, a market predicting an election outcome may have tokens for "Candidate A wins" and "Candidate B wins." The price of each token reflects the collective probability of that outcome as perceived by the market participants.
+
+- Oracles:
+To resolve the outcome of events, prediction markets rely on oracles, which fetch real-world data (e.g., election results or sports scores) and feed it into the blockchain to trigger smart contract settlements.
+
+- Decentralized Nature:
+Unlike traditional prediction markets, Web3 prediction markets operate on decentralized networks like Ethereum or Gnosis Chain. This ensures censorship resistance and global accessibility.
+
+- Liquidity Pools:
+Liquidity is often provided by automated market makers (AMMs) within the prediction market, ensuring that participants can trade tokens even in low-volume markets.
+
+## Benefits of Prediction Markets in Web3
+- Transparency:
+All trades, outcomes, and rules are recorded on the blockchain, ensuring verifiability and reducing the risk of fraud.
+
+- Censorship Resistance:
+Web3 prediction markets are not controlled by a centralized entity, making them resistant to government or corporate interference.
+
+- Trustlessness:
+Smart contracts automate the execution of market rules, ensuring fair payouts without requiring trust in a third party.
+
+- Global Accessibility:
+Anyone with internet access and a Web3 wallet can participate, removing geographical or financial barriers.
+
+- Accurate Market Sentiment:
+Prediction markets often provide a more accurate reflection of the probability of events because participants have financial incentives to base their trades on real information or beliefs.
+