Update Polymarket documentation (2026-02-19)
- Added new documentation URLs from llms.txt index - Updated TARGET.md with 244 total documentation pages - Scraped new pages for trading, concepts, and API reference sections - Updated changelog and new index pages
This commit is contained in:
AI Agent
@@ -2,101 +2,58 @@
|
||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||
> Use this file to discover all available pages before exploring further.
|
||||
|
||||
# Endpoints
|
||||
# Introduction
|
||||
|
||||
> All Polymarket API URLs and base endpoints
|
||||
> Overview of the Polymarket APIs
|
||||
|
||||
All base URLs for Polymarket APIs. See individual API documentation for available routes and parameters.
|
||||
The Polymarket API provides programmatic access to the world's largest prediction market. The platform is served by three separate APIs, each handling a different domain.
|
||||
|
||||
***
|
||||
|
||||
## REST APIs
|
||||
## APIs
|
||||
|
||||
| API | Base URL | Description |
|
||||
| ------------- | ---------------------------------- | ------------------------------------ |
|
||||
| **CLOB API** | `https://clob.polymarket.com` | Order management, prices, orderbooks |
|
||||
| **Gamma API** | `https://gamma-api.polymarket.com` | Market discovery, metadata, events |
|
||||
| **Data API** | `https://data-api.polymarket.com` | User positions, activity, history |
|
||||
<CardGroup cols={1}>
|
||||
<Card title="Gamma API" icon="database">
|
||||
**`https://gamma-api.polymarket.com`**
|
||||
|
||||
Markets, events, tags, series, comments, sports, search, and public profiles. This is the primary API for discovering and browsing market data.
|
||||
</Card>
|
||||
|
||||
<Card title="Data API" icon="chart-line">
|
||||
**`https://data-api.polymarket.com`**
|
||||
|
||||
User positions, trades, activity, holder data, open interest, leaderboards, and builder analytics.
|
||||
</Card>
|
||||
|
||||
<Card title="CLOB API" icon="arrows-rotate">
|
||||
**`https://clob.polymarket.com`**
|
||||
|
||||
Orderbook data, pricing, midpoints, spreads, and price history. Also handles order placement, cancellation, and other trading operations. Trading endpoints require [authentication](/api-reference/authentication).
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
<Info>
|
||||
A separate **Bridge API** (`https://bridge.polymarket.com`) handles deposits and withdrawals. Bridges are not handled by Polymarket, it is a proxy of fun.xyz service.
|
||||
</Info>
|
||||
|
||||
***
|
||||
|
||||
## WebSocket Endpoints
|
||||
## Authentication
|
||||
|
||||
| Service | URL | Description |
|
||||
| ------------------ | ------------------------------------------------ | ----------------------------------- |
|
||||
| **CLOB WebSocket** | `wss://ws-subscriptions-clob.polymarket.com/ws/` | Orderbook updates, order status |
|
||||
| **RTDS** | `wss://ws-live-data.polymarket.com` | Low-latency crypto prices, comments |
|
||||
The Gamma API and Data API are fully public — no authentication required.
|
||||
|
||||
The CLOB API has both public endpoints (orderbook, prices) and authenticated endpoints (order management). See [Authentication](/api-reference/authentication) for details.
|
||||
|
||||
***
|
||||
|
||||
## Quick Reference
|
||||
## Next Steps
|
||||
|
||||
### CLOB API
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Authentication" icon="key" href="/api-reference/authentication">
|
||||
Learn how to authenticate requests for trading endpoints.
|
||||
</Card>
|
||||
|
||||
```
|
||||
https://clob.polymarket.com
|
||||
```
|
||||
|
||||
Common endpoints:
|
||||
|
||||
* `GET /price` — Get current price for a token
|
||||
* `GET /book` — Get orderbook for a token
|
||||
* `GET /midpoint` — Get midpoint price
|
||||
* `POST /order` — Place an order (auth required)
|
||||
* `DELETE /order` — Cancel an order (auth required)
|
||||
|
||||
[Full CLOB documentation →](/developers/CLOB/introduction)
|
||||
|
||||
### Gamma API
|
||||
|
||||
```
|
||||
https://gamma-api.polymarket.com
|
||||
```
|
||||
|
||||
Common endpoints:
|
||||
|
||||
* `GET /events` — List events
|
||||
* `GET /markets` — List markets
|
||||
* `GET /events/{id}` — Get event details
|
||||
|
||||
[Full Gamma documentation →](/developers/gamma-markets-api/overview)
|
||||
|
||||
### Data API
|
||||
|
||||
```
|
||||
https://data-api.polymarket.com
|
||||
```
|
||||
|
||||
Common endpoints:
|
||||
|
||||
* `GET /positions` — Get user positions
|
||||
* `GET /activity` — Get user activity
|
||||
* `GET /trades` — Get trade history
|
||||
|
||||
[Full Data API documentation →](/developers/misc-endpoints/data-api-get-positions)
|
||||
|
||||
### CLOB WebSocket
|
||||
|
||||
```
|
||||
wss://ws-subscriptions-clob.polymarket.com/ws/
|
||||
```
|
||||
|
||||
Channels:
|
||||
|
||||
* `market` — Orderbook and price updates (public)
|
||||
* `user` — Order status updates (authenticated)
|
||||
|
||||
[Full WebSocket documentation →](/developers/CLOB/websocket/wss-overview)
|
||||
|
||||
### RTDS (Real-Time Data Stream)
|
||||
|
||||
```
|
||||
wss://ws-live-data.polymarket.com
|
||||
```
|
||||
|
||||
Channels:
|
||||
|
||||
* Crypto price feeds
|
||||
* Comment streams
|
||||
|
||||
[Full RTDS documentation →](/developers/RTDS/RTDS-overview)
|
||||
<Card title="Clients & SDKs" icon="cube" href="/api-reference/clients-sdks">
|
||||
Official TypeScript, Python, and Rust libraries.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@@ -1,79 +1 @@
|
||||
> ## Documentation Index
|
||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||
> Use this file to discover all available pages before exploring further.
|
||||
|
||||
# Glossary
|
||||
|
||||
> Key terms and concepts for Polymarket developers
|
||||
|
||||
## Markets & Events
|
||||
|
||||
| Term | Definition |
|
||||
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| **Event** | A collection of related markets grouped under a common topic. Example: "2024 US Presidential Election" contains markets for each candidate. |
|
||||
| **Market** | A single tradeable outcome within an event. Each market has a Yes and No side. Corresponds to a condition ID, question ID, and pair of token IDs. |
|
||||
| **Token** | Represents a position in a specific outcome (Yes or No). Prices range from 0.00 to 1.00. Winning tokens redeem for \$1 USDCe. Also called *outcome token* or referenced by *token ID*. |
|
||||
| **Token ID** | The unique identifier for a specific outcome token. Required when placing orders or querying prices. |
|
||||
| **Condition ID** | Onchain identifier for a market's resolution condition. Used in CTF operations. |
|
||||
| **Question ID** | Identifier linking a market to its resolution oracle (UMA). |
|
||||
| **Slug** | Human-readable URL identifier for a market or event. Found in Polymarket URLs: `polymarket.com/event/[slug]` |
|
||||
|
||||
***
|
||||
|
||||
## Trading
|
||||
|
||||
| Term | Definition |
|
||||
| ------------- | -------------------------------------------------------------------------------------------------------------------------- |
|
||||
| **CLOB** | Central Limit Order Book. Polymarket's off-chain order matching system. Orders are matched here before onchain settlement. |
|
||||
| **Tick Size** | The minimum price increment for a market. Usually `0.01` (1 cent) or `0.001` (0.1 cent). |
|
||||
| **Fill** | When an order is matched and executed. Orders can be partially or fully filled. |
|
||||
|
||||
***
|
||||
|
||||
## Order Types
|
||||
|
||||
| Term | Definition |
|
||||
| ------- | ---------------------------------------------------------------------------------------------------------------- |
|
||||
| **GTC** | Good-Til-Cancelled. An order that remains open until filled or manually cancelled. |
|
||||
| **GTD** | Good-Til-Date. An order that expires at a specified time if not filled. |
|
||||
| **FOK** | Fill-Or-Kill. An order that must be filled entirely and immediately, or it's cancelled. No partial fills. |
|
||||
| **FAK** | Fill-And-Kill. An order that fills as much as possible immediately, then cancels any remaining unfilled portion. |
|
||||
|
||||
***
|
||||
|
||||
## Market Types
|
||||
|
||||
| Term | Definition |
|
||||
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| **Binary Market** | A market with exactly two outcomes: Yes and No. The prices always sum to approximately \$1. |
|
||||
| **Negative Risk (NegRisk)** | A multi-outcome event where only one outcome can resolve Yes. Requires `negRisk: true` in order parameters. [Details](/developers/neg-risk/overview) |
|
||||
|
||||
***
|
||||
|
||||
## Wallets
|
||||
|
||||
| Term | Definition |
|
||||
| ------------------ | ------------------------------------------------------------------------------------------------ |
|
||||
| **EOA** | Externally Owned Account. A standard Ethereum wallet controlled by a private key. |
|
||||
| **Funder Address** | The wallet address that holds funds and tokens for trading. |
|
||||
| **Signature Type** | Identifies wallet type when trading. `0` = EOA, `1` = Magic Link proxy, `2` = Gnosis Safe proxy. |
|
||||
|
||||
***
|
||||
|
||||
## Token Operations (CTF)
|
||||
|
||||
| Term | Definition |
|
||||
| ---------- | ------------------------------------------------------------------------------------ |
|
||||
| **CTF** | Conditional Token Framework. The onchain smart contracts that manage outcome tokens. |
|
||||
| **Split** | Convert USDCe into a complete set of outcome tokens (one Yes + one No). |
|
||||
| **Merge** | Convert a complete set of outcome tokens back into USDCe. |
|
||||
| **Redeem** | After resolution, exchange winning tokens for \$1 USDCe each. |
|
||||
|
||||
***
|
||||
|
||||
## Infrastructure
|
||||
|
||||
| Term | Definition |
|
||||
| ----------- | ------------------------------------------------------------------------- |
|
||||
| **Polygon** | The blockchain network where Polymarket operates. Chain ID: `137`. |
|
||||
| **USDCe** | The stablecoin used as collateral on Polymarket. Bridged USDC on Polygon. |
|
||||
null
|
||||
|
||||
Reference in New Issue
Block a user