Get comments by comment id
Source: https://docs.polymarket.com/api-reference/comments/get-comments-by-comment-id
api-reference/gamma-openapi.json get /comments/{id}
Get comments by user address
Source: https://docs.polymarket.com/api-reference/comments/get-comments-by-user-address
api-reference/gamma-openapi.json get /comments/user_address/{user_address}
List comments
Source: https://docs.polymarket.com/api-reference/comments/list-comments
api-reference/gamma-openapi.json get /comments
Get closed positions for a user
Source: https://docs.polymarket.com/api-reference/core/get-closed-positions-for-a-user
api-reference/data-api-openapi.yaml get /closed-positions Fetches closed positions for a user(address)
Get current positions for a user
Source: https://docs.polymarket.com/api-reference/core/get-current-positions-for-a-user
api-reference/data-api-openapi.yaml get /positions Returns positions filtered by user and optional filters.
Get top holders for markets
Source: https://docs.polymarket.com/api-reference/core/get-top-holders-for-markets
api-reference/data-api-openapi.yaml get /holders
Get total value of a user's positions
Source: https://docs.polymarket.com/api-reference/core/get-total-value-of-a-users-positions
api-reference/data-api-openapi.yaml get /value
Get trades for a user or markets
Source: https://docs.polymarket.com/api-reference/core/get-trades-for-a-user-or-markets
api-reference/data-api-openapi.yaml get /trades
Get user activity
Source: https://docs.polymarket.com/api-reference/core/get-user-activity
api-reference/data-api-openapi.yaml get /activity Returns on-chain activity for a user.
Get event by id
Source: https://docs.polymarket.com/api-reference/events/get-event-by-id
api-reference/gamma-openapi.json get /events/{id}
Get event by slug
Source: https://docs.polymarket.com/api-reference/events/get-event-by-slug
api-reference/gamma-openapi.json get /events/slug/{slug}
Get event tags
Source: https://docs.polymarket.com/api-reference/events/get-event-tags
api-reference/gamma-openapi.json get /events/{id}/tags
List events
Source: https://docs.polymarket.com/api-reference/events/list-events
api-reference/gamma-openapi.json get /events
Health check
Source: https://docs.polymarket.com/api-reference/health/health-check
api-reference/data-api-openapi.yaml get /
Get market by id
Source: https://docs.polymarket.com/api-reference/markets/get-market-by-id
api-reference/gamma-openapi.json get /markets/{id}
Get market by slug
Source: https://docs.polymarket.com/api-reference/markets/get-market-by-slug
api-reference/gamma-openapi.json get /markets/slug/{slug}
Get market tags by id
Source: https://docs.polymarket.com/api-reference/markets/get-market-tags-by-id
api-reference/gamma-openapi.json get /markets/{id}/tags
List markets
Source: https://docs.polymarket.com/api-reference/markets/list-markets
api-reference/gamma-openapi.json get /markets
Get live volume for an event
Source: https://docs.polymarket.com/api-reference/misc/get-live-volume-for-an-event
api-reference/data-api-openapi.yaml get /live-volume
Get open interest
Source: https://docs.polymarket.com/api-reference/misc/get-open-interest
api-reference/data-api-openapi.yaml get /oi
Get total markets a user has traded
Source: https://docs.polymarket.com/api-reference/misc/get-total-markets-a-user-has-traded
api-reference/data-api-openapi.yaml get /traded
Get multiple order books summaries by request
Source: https://docs.polymarket.com/api-reference/orderbook/get-multiple-order-books-summaries-by-request
api-reference/clob-subset-openapi.yaml post /books Retrieves order book summaries for specified tokens via POST request
Get order book summary
Source: https://docs.polymarket.com/api-reference/orderbook/get-order-book-summary
api-reference/clob-subset-openapi.yaml get /book Retrieves the order book summary for a specific token
Get market price
Source: https://docs.polymarket.com/api-reference/pricing/get-market-price
api-reference/clob-subset-openapi.yaml get /price Retrieves the market price for a specific token and side
Get midpoint price
Source: https://docs.polymarket.com/api-reference/pricing/get-midpoint-price
api-reference/clob-subset-openapi.yaml get /midpoint Retrieves the midpoint price for a specific token
Get multiple market prices
Source: https://docs.polymarket.com/api-reference/pricing/get-multiple-market-prices
api-reference/clob-subset-openapi.yaml get /prices Retrieves market prices for multiple tokens and sides
Get multiple market prices by request
Source: https://docs.polymarket.com/api-reference/pricing/get-multiple-market-prices-by-request
api-reference/clob-subset-openapi.yaml post /prices Retrieves market prices for specified tokens and sides via POST request
Get price history for a traded token
Source: https://docs.polymarket.com/api-reference/pricing/get-price-history-for-a-traded-token
api-reference/clob-subset-openapi.yaml get /prices-history Fetches historical price data for a specified market token
Search markets, events, and profiles
Source: https://docs.polymarket.com/api-reference/search/search-markets-events-and-profiles
api-reference/gamma-openapi.json get /public-search
Get series by id
Source: https://docs.polymarket.com/api-reference/series/get-series-by-id
api-reference/gamma-openapi.json get /series/{id}
List series
Source: https://docs.polymarket.com/api-reference/series/list-series
api-reference/gamma-openapi.json get /series
Get sports metadata information
Source: https://docs.polymarket.com/api-reference/sports/get-sports-metadata-information
api-reference/gamma-openapi.json get /sports Retrieves metadata for various sports including images, resolution sources, ordering preferences, tags, and series information. This endpoint provides comprehensive sport configuration data used throughout the platform.
List teams
Source: https://docs.polymarket.com/api-reference/sports/list-teams
api-reference/gamma-openapi.json get /teams
Get bid-ask spreads
Source: https://docs.polymarket.com/api-reference/spreads/get-bid-ask-spreads
api-reference/clob-subset-openapi.yaml post /spreads Retrieves bid-ask spreads for multiple tokens
Get related tags (relationships) by tag id
Source: https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-id
api-reference/gamma-openapi.json get /tags/{id}/related-tags
Get related tags (relationships) by tag slug
Source: https://docs.polymarket.com/api-reference/tags/get-related-tags-relationships-by-tag-slug
api-reference/gamma-openapi.json get /tags/slug/{slug}/related-tags
Get tag by id
Source: https://docs.polymarket.com/api-reference/tags/get-tag-by-id
api-reference/gamma-openapi.json get /tags/{id}
Get tag by slug
Source: https://docs.polymarket.com/api-reference/tags/get-tag-by-slug
api-reference/gamma-openapi.json get /tags/slug/{slug}
Get tags related to a tag id
Source: https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-id
api-reference/gamma-openapi.json get /tags/{id}/related-tags/tags
Get tags related to a tag slug
Source: https://docs.polymarket.com/api-reference/tags/get-tags-related-to-a-tag-slug
api-reference/gamma-openapi.json get /tags/slug/{slug}/related-tags/tags
List tags
Source: https://docs.polymarket.com/api-reference/tags/list-tags
api-reference/gamma-openapi.json get /tags
Polymarket Changelog
Source: https://docs.polymarket.com/changelog/changelog
Welcome to the Polymarket Changelog. Here you will find any important changes to Polymarket, including but not limited to CLOB, API, UI and Mobile Applications.
Crypto Price Feeds: Access real-time cryptocurrency prices from two sources (Binance & Chainlink)
Comment Streaming: Real-time updates for comment events including new comments, replies, and reactions
Dynamic Subscriptions: Add, remove, and modify subscriptions without reconnecting
TypeScript Client: Official TypeScript client available at real-time-data-client For complete documentation, see RTDS Overview.
There has been a significant change to the structure of the price change message. This update will be applied at 11PM UTC September 15, 2025. We apologize for the short notice
- Please see the migration guide for details.
Reduced maximum values for query parameters on Data-API /trades and /activity:
limit: 500offset: 1,000
The batch orders limit has been increased from from 5 -> 15. Read more about the batch orders functionality here.
We’re adding new fields to the
get-bookandget-booksCLOB endpoints to include key market metadata that previously required separate queries.min_order_size- type: string
- description: Minimum allowed order size.
neg_risk- type: boolean
- description: Boolean indicating whether the market is neg_risk.
tick_size- type: string
- description: Minimum allowed order size.
We’re excited to roll out a highly requested feature: order batching. With this new endpoint, users can now submit up to five trades in a single request. To help you get started, we’ve included sample code demonstrating how to use it. Please see Place Multiple Orders (Batching) for more details.
We're adding a new
sidefield to theMakerOrderportion of the trade object. This field will indicate whether the maker order is abuyorsell, helping to clarify trade events where the maker side was previously ambiguous. For more details, refer to the MakerOrder object on the Get Trades page.The 100 token subscription limit has been removed for the Markets channel. You can now subscribe to as many token IDs as needed for your use case.
New Subscribe Field
initial_dump- Optional field to indicate whether you want to receive the initial order book state when subscribing to a token or list of tokens.
default: true
We’re excited to introduce a new order type soon to be available to all users: Fill and Kill (FAK). FAK orders behave similarly to the well-known Fill or Kil(FOK) orders, but with a key difference:
- FAK will fill as many shares as possible immediately at your specified price, and any remaining unfilled portion will be canceled.
- Unlike FOK, which requires the entire order to fill instantly or be canceled, FAK is more flexible and aims to capture partial fills if possible.
All API users will enjoy increased rate limits for the CLOB endpoints.
- CLOB - /books (website) (300req - 10s / Throttle requests over the maximum configured rate)
- CLOB - /books (50 req - 10s / Throttle requests over the maximum configured rate)
- CLOB - /price (100req - 10s / Throttle requests over the maximum configured rate)
- CLOB markets/0x (50req / 10s - Throttle requests over the maximum configured rate)
- CLOB POST /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rateed
- CLOB POST /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate
- CLOB DELETE /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rate
- DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate
null
Source: https://docs.polymarket.com/developers/CLOB/authentication
There are two levels of authentication to be considered when using Polymarket’s CLOB.
All signing can be handled directly by the client libraries. <Tip>This is information for advanced users who are NOT using our Python or Typescript Clients. Our provided clients handle signing and authentication for you.</Tip>
本篇目录
- L1: Private Key Authentication
- L2: API Key Authentication
- Create API Key
- Derive API Key
- Get API Keys
- Delete API Key
- Access Status
- Get Closed Only Mode Status
- Order Utils
- System
- API
- Security
- Fees
- Additional Resources
- How do I interpret the OrderFilled onchain event?
- Allowances
- Signature Types
- Validity Checks
- Overview
- Statuses
- Book Message
- price\change Message
- tick\size\change Message
- last\trade\price Message
- Trade Message
- Order Message
- Overview
- Subscription
- Deployment
- Resources
- Overview
- Subscription Details
- Subscription Message
- Message Format
- Message Types
- Payload Fields
- Parent Entity Types
- Example Messages
- Comment Hierarchy
- Use Cases
- Content
- Notes
- Overview
- Binance Source (cryptoprices)
- Chainlink Source (cryptopriceschainlink)
- Message Format
- Payload Fields
- Example Messages
- Supported Symbols
- Notes
- Overview
- Available Subscription Types
- Message Structure
- Subscription Management
- Error Handling
- Overview
- 1. Fetch by Slug
- 2. Fetch by Tags
- 3. Fetch All Active Markets
- Best Practices
- Related Endpoints
- Augmented Negative Risk
- Overview
- Deployments
- Overview
- Clarifications
- Resolution Process
- Deployed Addresses
- Additional Resources
- Overview
- Methodology
- Equations
- Steps
- Subgraph Overview
- Source
- Hosted Version
- Polymarket is different in three ways:
- Why USDC?
- Buying USDC
- Transfering to Polymarket
- Recommended Bridges
- Important Notes
- How do I use Transfer Crypto?
- What can I transfer?
- Need help with your deposit?
- Depositing funds on Polymarket
- About USDC and Polygon
- Video guide
- Walkthrough
- Quick Overview
- Outcomes
- Overview
- Clarifications
- Can I create my own market?
- Overview
- What are we doing?
- Reward Rate and Conditions
- Eligible Events:
- Initial Price
- Future Price
- Video guide
- What are Limit Orders?
- Managing limit orders
- Canceling limit orders
- Overview
- Seeing Rewards in the Order Book
- Learn more
- Video Walkthrough
- Placing a Market Order
- Viewing the Order Book
- Managing open orders
- Canceling open orders
- How Rate Limiting Works
- General Rate Limits
- Data API Rate Limits
- GAMMA API Rate Limits
- CLOB API Rate Limits
- Other API Rate Limits
- Getting your API Keys
- Using those keys to connect to the Market or User Websocket