# Pythia Oracle

> Pythia is an AI-managed oracle delivering calculated technical indicators on-chain. Unlike price-only oracles, Pythia provides EMA, RSI, VWAP, Bollinger Bands, volatility, and liquidity metrics — computed server-side and delivered to smart contracts via Chainlink.

Pythia serves 572 indicator instances across 26 tokens from 8 ecosystems, delivered on 2 mainnet chains (Polygon PoS, Arbitrum One). Indicators are available at 4 timeframes (5-minute, 1-hour, 1-day, 1-week) and 5 pricing tiers.

## Integration

- Faucet Contract (Free Trial): `0x640fC3B9B607E324D7A3d89Fcb62C77Cc0Bd420A` — Call `requestIndicator(feed)` on Polygon Amoy, no LINK needed, 5 requests/day/address
### Polygon PoS
- [Discovery (0.01 LINK)](https://polygonscan.com/address/0xeC2865d66ae6Af47926B02edd942A756b394F820): Any single indicator for any token — per call.
- [Analysis (0.03 LINK)](https://polygonscan.com/address/0x3b3aC62d73E537E3EF84D97aB5B84B51aF8dB316): All hourly, daily, and weekly indicators for a token — per call.
- [Speed (0.05 LINK)](https://polygonscan.com/address/0xC406e7d9AC385e7AB43cBD56C74ad487f085d47B): All 5-minute indicators for a token — per call.
- [Complete (0.1 LINK)](https://polygonscan.com/address/0x2dEC98fd7173802b351d1E28d0Cd5DdD20C24252): Every indicator, every timeframe — per call.
- [Operator Contract](https://polygonscan.com/address/0xAA37710aF244514691629Aa15f4A5c271EaE6891): Pythia's Chainlink Operator

### Arbitrum One
- [Discovery (0.01 LINK)](https://arbiscan.io/address/0xeC2865d66ae6Af47926B02edd942A756b394F820): Any single indicator for any token — per call.
- [Analysis (0.03 LINK)](https://arbiscan.io/address/0x3b3aC62d73E537E3EF84D97aB5B84B51aF8dB316): All hourly, daily, and weekly indicators for a token — per call.
- [Speed (0.05 LINK)](https://arbiscan.io/address/0xC406e7d9AC385e7AB43cBD56C74ad487f085d47B): All 5-minute indicators for a token — per call.
- [Complete (0.1 LINK)](https://arbiscan.io/address/0x2dEC98fd7173802b351d1E28d0Cd5DdD20C24252): Every indicator, every timeframe — per call.
- [Operator Contract](https://arbiscan.io/address/0xAA37710aF244514691629Aa15f4A5c271EaE6891): Pythia's Chainlink Operator

## Available Indicators

- **EMA (Exponential Moving Average):** 20-period EMA at each timeframe. Feed format: `{engine_id}_EMA_{timeframe}_{period}` (e.g., `aave_EMA_5M_20`)
- **RSI (Relative Strength Index):** 14-period RSI. Feed format: `{engine_id}_RSI_{timeframe}_{period}` (e.g., `pol_RSI_1H_14`)
- **VWAP (Volume-Weighted Average Price):** Feed format: `{engine_id}_VWAP_{timeframe}`
- **Bollinger Bands (Upper/Mid/Lower):** 20-period, 2 std dev. Feed format: `{engine_id}_BOLLINGER_{UPPER|MID|LOWER}_{timeframe}_20`
- **Volatility:** Standard deviation-based. Feed format: `{engine_id}_VOLATILITY_{timeframe}`
- **Liquidity:** Depth metric. Feed format: `{engine_id}_LIQUIDITY_{timeframe}`

## Supported Tokens

AAVE, ARPA, AVAX, BAL, BNB, BTC, COMP, CRV, ETH, FET, INJ, LDO, LINK, MORPHO, ONDO, POL, QUICK, RENDER, SOL, SUI, TAO, TIA, UNI, W, XAUT, ZRO

Engine IDs (used in feed names): `aave`, `arpa`, `avalanche-2`, `balancer`, `binancecoin`, `bitcoin`, `compound-governance-token`, `curve-dao-token`, `ethereum`, `artificial-superintelligence-alliance`, `injective-protocol`, `lido-dao`, `chainlink`, `morpho`, `ondo-finance`, `pol`, `quickswap`, `render-token`, `solana`, `sui`, `bittensor`, `celestia`, `uniswap`, `wormhole`, `tether-gold`, `zro`

## Timeframes

- `5M` — 5-minute (Speed tier)
- `1H` — 1-hour (Analysis tier)
- `1D` — 1-day (Analysis tier)
- `1W` — 1-week (Analysis tier)

## Pricing Tiers

| Tier | Fee | Use When |
|------|-----|----------|
| Discovery | 0.01 LINK | Any single indicator for any token — per call. |
| Analysis | 0.03 LINK | All hourly, daily, and weekly indicators for a token — per call. |
| Speed | 0.05 LINK | All 5-minute indicators for a token — per call. |
| Complete | 0.1 LINK | Every indicator, every timeframe — per call. |
| Events | 1.0 LINK | Automated indicator alerts — subscribe once, get notified when conditions match. 1 LINK/day. |

## How It Works

1. Your smart contract calls a Pythia consumer contract with a feed name (e.g., `aave_RSI_1H_14`)
2. The consumer forwards the request to Pythia's Chainlink Operator with LINK payment
3. Pythia's off-chain engine queries 4 redundant price sources, computes the indicator, and returns the result
4. The Operator delivers the result to your contract's callback function

LINK token (ERC-677) per chain:
- Polygon PoS: `0xb0897686c545045aFc77CF20eC7A532E3120E0F1`
- Arbitrum One: `0xf97f4df75117a78c1A5a0DBb814Af92458539FB4`

## Pythia Events (On-Chain Indicator Alerts)

Subscribe once, get notified when your condition is met. One-shot: fires once, remaining whole days refunded in LINK.
- Pricing: 1 LINK/day per subscription
- Active conditions: ABOVE (0), BELOW (1)
- Threshold: 8 decimal places (e.g. RSI 30 = 3000000000)
- Refund: Unused whole days refunded on fire or cancel
- Registry (mainnet): `0x73686087d737833C5223948a027E13B608623e21`
- Registry (arb-sepolia): `0xEFDD50819E2316360feB7833F8e2ffBBE3C5AaB2`
- Registry (amoy): `0x931Aa640d29E6C9D9fB3002749a52EC7fb277f9c`
- Registry (arbitrum): `0xA9B13Eb4B98CEE9Cc05EFB10861a77482Ae0bD9e`

## Pythia Visions (AI Market Intelligence)

AI-calibrated market intelligence delivered on-chain. 12 walk-forward validated patterns (2017-2026) across 7 tokens, with honest accuracy + fire-frequency disclosure. FREE to subscribe.
- Registry (mainnet): `0x39407eEc3Ba80746BC6156eD924D16C2689533Ed`
- Registry (arb-sepolia): `0x5e32C6B193b1D2a41E3a249aee0200220aff3dB4`
- Registry (arbitrum): `0x7585062b5410AE7fADd841e2100F037a4F372B3C`
- Evaluation: Every 6 hours
- Tokens: AVAX, BNB, BTC, ETH, LINK, POL, SOL
- BTC OVERSOLD_REVERSION (0x10): 58-66% accuracy, +0.5% to +2% avg return, ~100/yr
- BTC CAPITULATION_EVENT (0x11): 60-90% accuracy, +3% to +8% avg return, ~7/yr
- ETH CAPITULATION_EVENT (0x20): 50-80% accuracy, +2% to +8% avg return, ~13/yr
- ETH OVERSOLD_REVERSION (0x21): 55-65% accuracy, +0.5% to +1.5% avg return, ~147/yr
- SOL OVERSOLD_REVERSION (0x30): 53-63% accuracy, +0.3% to +1.5% avg return, ~219/yr
- LINK OVERSOLD_REVERSION (0x40): 54-64% accuracy, +0.5% to +1.5% avg return, ~226/yr
- LINK CAPITULATION_EVENT (0x41): 55-80% accuracy, +3% to +10% avg return, ~20/yr
- AVAX CAPITULATION_EVENT (0x50): 55-80% accuracy, +3% to +10% avg return, ~21/yr
- BNB OVERSOLD_REVERSION (0x60): 58-68% accuracy, +0.5% to +2.5% avg return, ~136/yr
- BNB CAPITULATION_EVENT (0x61): 55-80% accuracy, +3% to +10% avg return, ~15/yr
- POL OVERSOLD_REVERSION (0x70): 53-63% accuracy, +0.5% to +2% avg return, ~256/yr
- POL CAPITULATION_EVENT (0x71): 55-80% accuracy, +3% to +10% avg return, ~39/yr

## Links

- [Website & Feed Explorer](https://pythia.c3x-solutions.com): Live feed status, pricing, developer docs
- [MCP Server](https://pypi.org/project/pythia-oracle-mcp/): `pip install pythia-oracle-mcp` — works with Claude, Cursor, Windsurf, OpenAI agents
- [LangChain Integration](https://pypi.org/project/langchain-pythia/): `pip install langchain-pythia`
- [GitHub Examples](https://github.com/pythia-the-oracle/pythia-oracle-examples): Solidity consumer contracts and integration guides
- [GitHub MCP Source](https://github.com/pythia-the-oracle/pythia-oracle-mcp): MCP server source code
- [Telegram](https://t.me/pythia_the_oracle): Community and updates
- [Twitter/X](https://x.com/PythiaOracle): Announcements
- [dev.to](https://dev.to/pythiatheoracle): Tutorials and guides
- [Complete Documentation (llms-full.txt)](https://pythia.c3x-solutions.com/llms-full.txt): Full inline documentation for AI agents

## Optional

- [PythiaFaucet Solidity Source](https://arbiscan.io/address/0x640fC3B9B607E324D7A3d89Fcb62C77Cc0Bd420A#code): Verified contract — reference implementation for consuming Pythia feeds
- [PythiaBundleConsumer Source](https://arbiscan.io/address/0x3b3aC62d73E537E3EF84D97aB5B84B51aF8dB316#code): Bundle consumer reference
- [PythiaDiscoveryConsumer Source](https://arbiscan.io/address/0xeC2865d66ae6Af47926B02edd942A756b394F820#code): Single-indicator consumer reference