Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt

Use this file to discover all available pages before exploring further.

​
April 21, 2026
v0.0.26
  • Retail Orders API: documented three batched endpoints: POST /v1/orders/batched, /v1/orders/batched/cancel, /v1/orders/batched/modify. The first two were already shipped; the third is new.
  • Retail Orders API: documented outcomeSide + action as an alternative to intent on CreateOrderRequest, and added both fields to the Order response. intent is no longer marked required on CreateOrderRequest. Existing requests that send intent keep working; regenerated clients will see it flip from required to optional.
  • Retail Orders API: added enum members that were already on the wire but missing from the schema: TIME_IN_FORCE_DAY, ORDER_STATE_NEW, EXECUTION_TYPE_NEW, ORD_REJECT_REASON_EXCHANGE_OPTION.
​
April 17, 2026
v0.0.25
  • Corrected production gRPC endpoint from grpc-api.polymarketexchange.com to grpc-api.prod.polymarketexchange.com
​
April 13, 2026
v0.0.24
  • Weekly maintenance window moved from Tuesday 4am–6am ET to Thursday 6am–8am ET, effective April 16, 2026
​
April 10, 2026
v0.0.23
  • Updated rate limits across all APIs:
    • Institutional Gateway (REST/gRPC): reduced to 100 messages per second per firm
    • FIX Protocol: reduced to 150 messages per second per session (all participants)
    • Retail API: reduced to 20 requests per second per API key
​
March 30, 2026
v0.0.22
  • FIX API: Product field (tag 460) changed from required to optional on New Order Single. All current products on Polymarket are Product=12 (OTHER).
  • Corrected REST API routes: /v1/accounts/whoami → /v1/whoami, /v1/accounts/users → /v1/users, /v1/accounts/accounts → /v1/accounts
  • Fixed price scale examples across documentation to reflect correct values
  • Corrected production API base URLs to api.prod.polymarketexchange.com across all documentation
​
March 3, 2026
v0.0.21
  • Edited proto files to improve the gRPC streaming experience
  • state field changed from required to optional in three messages:
    • MarketDataUpdate.state (field 4) in marketdatasubscription.proto
    • GetOrderBookResponse.state (field 4) in orderbook.proto
    • GetBBOResponse.state (field 6) in orderbook.proto
  • Participants should utilize the instrument state change subscription for state changes
​
February 26, 2026
v0.0.20
  • Updated settlement responses in marketdatasubscription, adding settlement_price_calculation_text
  • Added price_scale to order message
​
January 10, 2026
v0.0.19
  • Added Bidirectional Market Data Streaming API: BiDirectionalStreamMarketData RPC
  • Dynamically add and remove symbols during subscription lifetime without reconnecting
  • New response types: SubscriptionAck and SubscriptionError for subscription management
  • Updated client sample code with new Go and Python examples (Example 20)
  • Updated proto packages with bidirectional streaming support
​
January 4, 2026
v0.0.18
  • Added Account Valuation APIs for book-close accounting use cases
  • POST /v1/valuations/accounts/download: Multi-account summaries as CSV
  • All new endpoints support historical queries via as_of_time or as_of_date
  • Cross-ISV protection enforced on all valuation endpoints
​
January 3, 2026
v0.0.17
  • Documented configurable instrument queries: pagination, state filtering, and metadata filters
  • Added sports league filtering via metadata.sports_game_league (nfl, nba, mlb, nhl, cbb, cfb)
  • Added instrument metadata field documentation with sports-specific attributes
​
January 3, 2026
v0.0.16
  • Added Historical Positions API: query positions at any point in time using as_of_time (RFC3339 timestamp) or as_of_date (trade date)
  • Use cases: end-of-day reporting, regulatory snapshots, position reconciliation
​
January 3, 2026
v0.0.15
  • Documentation deployment refresh
​
December 31, 2025
v0.0.14
  • Added slow consumer handling option for streaming endpoints with skip-to-head behavior
  • Proto files now available for direct download (polymarket-protos.zip)
  • Added FAQ clarifying ISV-Participant relationship and participant_id usage
​
December 8, 2025
v0.0.13
  • Added 25 REST API endpoints with full OpenAPI documentation
  • New sections: Authentication, Accounts, Orders, Positions, Market Data, Drop Copy
  • Organized API documentation by functional category
​
November 25, 2025
v0.0.12
  • Added complete gRPC streaming API documentation with Python code examples for market data and order execution streams
  • Introduced Protocol Buffer reference documentation with detailed message structures and field definitions
  • Added VPC connection setup guide with AWS PrivateLink configuration instructions
  • Created common pitfalls troubleshooting guide for integration issues
​
August 18, 2025
v0.0.11
  • Aesthetic changes including new figures and cleaner formatting of FIX examples.
​
August 14, 2025
v0.0.10
  • First DRAFT of Polymarket Exchange Documentation