Skip to content

Releases: YichengYang-Ethan/oracle3

v1.0.0 — Oracle3: Autonomous On-Chain Trading Agent

10 Mar 01:49

Choose a tag to compare

Oracle3 v1.0.0

The first production release of Oracle3 — an autonomous on-chain trading agent for prediction markets on Solana, Polymarket, and Kalshi.

Highlights

8 Arbitrage Strategies with formal mathematical invariants:

  • Constraint-based: cross-market, exclusivity (P(A)+P(B)≤1), implication (P(A)≤P(B)), conditional (P(A|B)∈[L,U]), event-sum (Σ=1), structural (linear model)
  • Statistical: cointegration spread trading, lead-lag temporal arbitrage

On-Chain Agent Capabilities:

  • Native Solana transaction signing + Jito MEV protection
  • On-chain trade logging via Memo program + agent reputation scoring
  • Flash loan arbitrage + atomic multi-leg execution
  • Whale wallet signal detection + TVL monitoring

Trading Infrastructure:

  • SpreadExecutor with automatic LIFO unwind on partial fills
  • Engine control server (pause/resume/killswitch via Unix socket)
  • Strategy portfolio registry with lifecycle management
  • Market relation knowledge graph with quantitative validation

AI + Quant Hybrid:

  • LLM agent strategies via OpenAI Agents SDK with 8 built-in tools
  • Adaptive quantitative strategies with self-tuning weights
  • Multi-provider LLM support (OpenAI, DeepSeek, LiteLLM)

Dashboard & CLI:

  • Live web dashboard with real-time equity curve and 8 feature cards
  • Terminal TUI for headless environments
  • Full CLI for market browsing, trading, backtesting, and engine control

Quality:

  • 553 tests (pytest + pytest-asyncio + hypothesis)
  • Full CI/CD: ruff, mypy, codespell, MkDocs docs
  • Apache 2.0 license

Install

git clone https://github.com/YichengYang-Ethan/oracle3.git
cd oracle3
poetry install

Quick Demo

./demo.sh
# or
oracle3 dashboard --exchange solana \
  --strategy-ref oracle3.strategy.contrib.adaptive_onchain_strategy:AdaptiveOnChainStrategy \
  --initial-capital 10000

Open http://localhost:3000/live for the live dashboard.


Full changelog: CHANGELOG.md