Seesaw Protocol#
Solana onchain program for creating and interacting with price-referenced digital contracts
Seesaw is a Solana onchain program that enables anyone to interact with YES/NO shares on configurable-duration price-direction contracts through a fully on-chain order book with Pyth oracle integration. Onchain execution makes custody, matching, fees, and settlement auditable, while users still rely on the published Pyth resolution rule, available orderbook depth, wallet/RPC infrastructure, and disclosed governance authorities.
Quick Start#
New here? Start with the Getting Started tutorial, and read the Risks page before trading real funds.
Why Seesaw?#
- Permissionless - 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 with transparent on-chain state.
How These Docs Are Organized#
The documentation follows the Diátaxis framework: four kinds of pages for four kinds of need. Tutorials teach by doing, how-to guides get a task done, reference states the facts, and explanation builds understanding. Every page belongs to one of the four — if a page isn't serving you, one of the other three probably will.
Tutorials — learn by doing#
Guided lessons that take you from zero to a first success. Start here if Seesaw is new to you.
| Tutorial | What you'll accomplish |
|---|---|
| Getting Started | Place your first trade and claim a payout |
| SDK Quickstart | Fetch live markets and estimate a fill in code |
| CLI Walkthroughs | Drive a full market lifecycle from the terminal |
How-to guides — get a task done#
Task-oriented recipes for people who know what they want to do.
| Guides | Tasks covered |
|---|---|
| For Traders | Place orders, manage positions, claim winnings, create markets, earn referrals |
| Market Making | Provide two-sided liquidity |
| Automation | Run bots and crank operations |
| SDK Guide | Build transactions, read on-chain data, integrate referrals |
| CLI Guide | Install and operate the command-line interface |
| Troubleshooting | Diagnose and fix common problems |
Reference — look up the facts#
Neutral technical description: accurate, complete, and structured like the protocol itself.
| Reference | Contents |
|---|---|
| API Reference | REST endpoints, WebSocket channels, data schemas |
| Architecture | Account layouts, instructions, PDA derivations |
| Protocol Reference | Constants, error codes, glossary, market capacity |
| Protocol Invariants | The INV-* invariant catalogue |
| CLI Commands | Every command, flag, and configuration option |
Explanation — understand the system#
Background and reasoning: how the machinery behaves, and why it was built this way.
| Topic | What it explains |
|---|---|
| How It Works | Market lifecycle, order book, oracle, settlement, fees |
| Design Rationale | Why the protocol makes the choices it does |
| Security Model | Threat model and security guarantees |
| Risks | What can go wrong, and how to protect yourself |
Other Resources#
| Resource | Description |
|---|---|
| FAQ | Quick answers, linking to the full docs |
| Security Policy | Vulnerability reporting and security posture |
| Bug Bounty | Scope, rewards, and rules |
Built on Solana. Powered by Pyth.