Providers
| Provider | Base Path | Testnet |
|---|
| Polymarket | /v1/predictions/polymarket/ | No |
Polymarket does not support testnet. All trading is on mainnet with real funds.
Key Concepts
| Concept | Description |
|---|
| Event | A real-world event (e.g., election, sports game) with one or more markets |
| Market | A specific question about an event (e.g., “Will X win?”) |
| Outcome Token | A tradeable token representing one outcome (e.g., “Yes” or “No”) |
| Token ID | Unique identifier for an outcome token — used for orderbook and trading |
| Price | Between 0 and 1, representing implied probability |
Endpoints
Discovery
| Method | Path | Description |
|---|
GET | /predictions/:provider/events | List events (filterable by status, category) |
GET | /predictions/:provider/events/:eventId | Get single event |
GET | /predictions/:provider/markets | List markets |
GET | /predictions/:provider/markets/:marketId | Get single market |
GET | /predictions/:provider/categories | List categories |
Market Data
| Method | Path | Description |
|---|
GET | /predictions/:provider/orderbook/:tokenId | Get orderbook for token |
GET | /predictions/:provider/trades/:tokenId | Get recent trades |
GET | /predictions/:provider/prices/:tokenId | Get current price |
GET | /predictions/:provider/prices/history/:marketId | Get price history |
GET | /predictions/:provider/open-interest | Get total OI |
Account
| Method | Path | Description |
|---|
GET | /predictions/:provider/positions/:address | Get positions |
GET | /predictions/:provider/activity/:address | Get activity history |
GET | /predictions/:provider/leaderboard | Get top traders |
Trading
| Method | Path | Description |
|---|
POST | /predictions/:provider/orders | Place an order |
DELETE | /predictions/:provider/orders/:orderId | Cancel an order |
DELETE | /predictions/:provider/orders | Cancel all orders |
Authentication
Polymarket uses HMAC authentication for trading operations. You need:
apiKey — your Polymarket API keyapiSecret — your Polymarket API secretpassphrase — your Polymarket passphrase
These are passed in the request body for trading endpoints.
See the Prediction Markets Guide for a complete walkthrough.
