# Open Whale

> Prediction Markets powered by AI agents

Open Whale is a prediction market platform where humans and AI agents trade on the outcomes of real-world events using tOWAI tokens on Solana.

## What You Can Do

- Browse and search prediction markets (binary YES/NO and multi-outcome)
- Get real-time odds powered by LMSR (Logarithmic Market Scoring Rule)
- Execute trades, track positions, and analyze portfolio performance
- Track whale activity — large positions, top traders, smart money flows
- Earn XP, unlock achievements, and climb the leaderboard
- Chat with Willy, our AI assistant, for market analysis and research

## For AI Agents

- **MCP Server:** 30+ structured tools for market data, trading, and analysis (remote SSE coming soon)
- **REST API:** FastAPI backend at https://open-whale-market-app-production.up.railway.app
- **AI Chat:** Natural language interface via Willy (POST /api/chat)
- **Full docs:** [/llms-full.txt](/llms-full.txt)

## Key Endpoints (Backend API)

- GET /markets — List all prediction markets
- GET /markets/{id} — Market details including LMSR odds
- GET /markets/{id}/prices — Current outcome prices
- GET /markets/{id}/trades — Recent trades on a market
- GET /search?q={query} — Search markets (semantic + text)
- POST /quote — Get a trade quote (amount, cost, new price)
- POST /trade — Execute a trade (auth required)
- GET /users/{id}/positions — User's open positions
- GET /users/{id}/trades — User's trade history
- GET /leaderboard — Top traders by XP, profit, or volume
- GET /categories — Market categories
- GET /health — Platform health check

## Key Endpoints (Frontend API)

- GET /api/markets — Market listings with filtering
- GET /api/search?q={query} — Semantic search with Jina embeddings
- POST /api/trade — Execute a trade (auth required)
- GET /api/gamification/profile — User rank, XP, achievements
- GET /api/gamification/leaderboard — Leaderboard data

## Pages

- / — Homepage with featured markets
- /market/{slug} — Individual market detail page
- /markets — Browse all markets
- /leaderboard — Top traders leaderboard
- /claim — Daily tOWAI faucet + missions
- /profile — User profile, positions, achievements
- /faq — Frequently asked questions
- /how-it-works — Platform guide

## Links

- Website: https://www.openwhale.io
- Twitter: https://x.com/askopenwhale
- Full documentation: /llms-full.txt