Endpoint reference
Market Discovery
| API | Description |
|---|---|
| Search Markets | Query markets by keywords or tags |
| Get Trending Markets | Discover high-volume markets sorted by 24hr trading activity |
| Get Tags | Retrieve categories for filtering markets |
Market Information
| API | Description |
|---|---|
| Get Event | Retrieve complete event details with all associated markets |
| Get Markets | Query specific markets by token ID, slug, or category |
| Get Market Price | Fetch current best bid/ask prices |
| Get Price History | Analyze historical price data across different time intervals |
User Positions & Activity
| API | Description |
|---|---|
| Get Current Positions | View all open positions with PnL calculations |
| Get Closed Positions | Access historical positions from resolved markets |
| Get Trades | Retrieve detailed trade history |
| Get Activity | Comprehensive activity feed including orders and trades |
| Get PnL | Aggregate profit and loss summary |
Authentication
All API endpoints require authentication using API keys passed via thex-api-key header. We have provided a highly ratelimited API key for testing in the API playground.
Getting Started
- Discover Markets: Start with the search or trending endpoints to find markets
- Get Details: Use the market or event endpoints to fetch comprehensive information
- Track Prices: Monitor real-time prices and historical data
- Analyze Users: Query positions and activity for wallet addresses
Related Resources
- Polymarket Demo App - Test Swaps’ prediction market APIs by sending live Polymarket orders. Provides a reference for the discovery path and network requests to quickly add prediction markets to your app.
