Overview - Swaps API Documentation

Swaps enables users to trade on Polymarket directly from their wallet using any token on any chain. The prediction market data endpoints provide real time market information to build comprehensive applications on Polymarket.

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 the x-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

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.

​Endpoint reference

​Market Discovery

​Market Information

​User Positions & Activity

​Authentication

​Getting Started

​Related Resources