Skip to main content
Swaps enables users to trade on Polymarket using any token on any chain, directly from their existing wallet — instead of needing a Polymarket trading account and pUSD. This reference covers the full lifecycle: discovering markets, placing orders, tracking workflows, managing positions, and withdrawing funds. Why build prediction markets on Swaps:
  • One call to place a bet. A single getAction request swaps any token on any chain into collateral and places the order — the fastest path from “user holds ETH on Base” to “position on Polymarket”.
  • The full stack in one API. Market discovery, live prices, order placement, position management, PnL, and withdrawals — no stitching together separate data and execution providers.
  • Non-custodial by design. Every user gets a deposit wallet keyed to their own EOA, and every trading call is authorized by the user’s EIP-712 signature.
New to the integration? Start with the Integration Patterns guide — it compares the one-call chain-abstracted flow against the direct three-step flow — then follow the Transaction Lifecycle walkthrough.

​
Endpoint reference

​
Trading

​
Market Discovery

​
Market Information

​
User Positions & Activity

​
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

  1. Discover Markets: Start with the search or trending endpoints to find markets
  2. Place Orders: Pick an integration pattern and place your first order
  3. Track Workflows: Follow execution with Get Workflow Status
  4. Manage Positions: Sell, redeem, or merge positions and withdraw collateral
  • 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. Polymarket Demo App