Seesaw Protocol#
Autonomous smart contracts for creating and interacting with price-referenced digital contracts on Solana
Seesaw is a set of autonomous smart contracts that enable anyone to interact with YES/NO shares on configurable-duration price-direction contracts through a fully on-chain order book with Pyth oracle integration. No counterparty risk. No centralized operators. Just pure price discovery.
Quick Start#
How It Works#
Contracts open on a configurable cadence — from every 60 seconds to every 7 days — each referencing: Will the price go UP or DOWN?
| Share | What It Means | Payout if Correct |
|---|---|---|
| YES | Price will be UP (or unchanged) | 1 USDC per share |
| NO | Price will be DOWN | 1 USDC per share |
Prices come from Pyth Network - the same oracle used by major DeFi protocols. Resolution is automatic and trustless.
Why Seesaw?#
- Permissionless - No KYC, no restrictions. If you have a wallet, you can participate.
- Non-custodial - Your funds stay in your wallet until you place an order.
- Transparent - All orders, interactions, and settlements happen on-chain.
- Fast - Contracts from 1 minute to 7 days — pick your time horizon.
- Fair - Price-time priority matching. No front-running.
Documentation Sections#
For Traders#
| Section | Description |
|---|---|
| Getting Started | Overview for traders |
| Understanding Shares | YES/NO share mechanics |
| Placing Orders | Order types and execution |
| Managing Positions | Track and manage holdings |
| Claiming Winnings | Settlement process |
| Risks | Risks and considerations |
| Market Making | Provide liquidity |
| Automation | Automated strategies |
Developers#
| Section | Description |
|---|---|
| SDK Guide | Build applications on Seesaw |
| AI Agents | Autonomous agent integration |
| API Reference | REST and WebSocket APIs |
| Architecture | Technical deep-dives |
| Security | Security model and threat analysis |
| CLI Guide | Command-line interface reference |
Operators#
| Section | Description |
|---|---|
| Operations | Run Seesaw infrastructure |
| Cranking | Crank setup and operation |
| Monitoring | Protocol health monitoring |
Reference#
| Section | Description |
|---|---|
| Error Codes | All protocol error codes |
| Constants | Protocol constants and values |
| Glossary | Terminology definitions |
| Troubleshooting | Common issues and solutions |
Architecture Decisions#
| ADR | Description |
|---|---|
| ADR-001 | Single canonical order book design |
| ADR-002 | Pyth oracle integration |
| ADR-003 | Market epochs and configurable durations |
Market Lifecycle#
Live Example#
Market: SOL/USD (15-min duration)
Start: $142.50 @ 14:00:00 UTC
End: $143.20 @ 14:15:00 UTC
Result: UP (143.20 >= 142.50)
Winners: YES share holders
Payout: 1 USDC per YES share
Built on Solana. Powered by Pyth.