Update Polymarket documentation - March 30, 2026

Updated 229 documentation pages reflecting latest official docs changes:
- API Reference: authentication, rate-limits, clients-sdks, market-data endpoints
- Developers: CLOB, Gamma Markets, RTDS, Sports Websocket, Builders, CTF
- Trading: fees, bridge, orders, orderbook, clients
- Polymarket Learn: get-started guides, deposits, trading
- Builders: tiers, api-keys, profile, examples, order-attribution
- Quickstart: overview, first-order, websocket guides
- Concepts: markets-events, prices-orderbook, resolution
- Market Makers: getting-started, trading, liquidity-rewards
- Resources: error-codes, contract-addresses, blockchain-data
This commit is contained in:
Etherdrake
2026-03-30 12:53:20 +02:00
parent 240ece03cc
commit 50a13414c0
229 changed files with 7322 additions and 935 deletions
@@ -11,7 +11,7 @@
## OpenAPI
````yaml api-spec/clob-openapi.yaml delete /cancel-all
````yaml /api-spec/clob-openapi.yaml delete /cancel-all
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -37,6 +37,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/cancel-all:
delete:
@@ -166,3 +168,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
@@ -13,7 +13,7 @@ Works even in cancel-only mode.
## OpenAPI
````yaml api-spec/clob-openapi.yaml delete /orders
````yaml /api-spec/clob-openapi.yaml delete /orders
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -39,6 +39,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/orders:
delete:
@@ -206,3 +208,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
@@ -12,7 +12,7 @@ Works even in cancel-only mode.
## OpenAPI
````yaml api-spec/clob-openapi.yaml delete /cancel-market-orders
````yaml /api-spec/clob-openapi.yaml delete /cancel-market-orders
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -38,6 +38,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/cancel-market-orders:
delete:
@@ -201,3 +203,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
@@ -11,7 +11,7 @@
## OpenAPI
````yaml api-spec/clob-openapi.yaml delete /order
````yaml /api-spec/clob-openapi.yaml delete /order
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -37,6 +37,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/order:
delete:
@@ -190,3 +192,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
@@ -12,7 +12,7 @@ Builders can only see their own originated trades.
## OpenAPI
````yaml api-spec/clob-openapi.yaml get /builder/trades
````yaml /api-spec/clob-openapi.yaml get /builder/trades
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -38,6 +38,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/builder/trades:
get:
@@ -362,3 +364,5 @@ components:
description: Unix timestamp for builder authentication
````
Built with [Mintlify](https://mintlify.com).
@@ -17,7 +17,7 @@ An order is considered "scoring" if it meets all the criteria for earning maker
## OpenAPI
````yaml api-spec/clob-openapi.yaml get /order-scoring
````yaml /api-spec/clob-openapi.yaml get /order-scoring
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -43,6 +43,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/order-scoring:
get:
@@ -184,3 +186,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
@@ -5,13 +5,14 @@
# Get single order by ID
> Retrieves a specific order by its ID (order hash) for the authenticated user.
Builder-authenticated clients can also use this endpoint to retrieve orders attributed to their builder account.
## OpenAPI
````yaml api-spec/clob-openapi.yaml get /order/{orderID}
````yaml /api-spec/clob-openapi.yaml get /order/{orderID}
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -37,6 +38,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/order/{orderID}:
get:
@@ -46,6 +49,9 @@ paths:
description: >
Retrieves a specific order by its ID (order hash) for the authenticated
user.
Builder-authenticated clients can also use this endpoint to retrieve
orders attributed to their builder account.
operationId: getOrder
parameters:
- name: orderID
@@ -117,6 +123,10 @@ paths:
polySignature: []
polyPassphrase: []
polyTimestamp: []
- polyBuilderApiKey: []
polyBuilderPassphrase: []
polyBuilderSignature: []
polyBuilderTimestamp: []
components:
schemas:
OpenOrder:
@@ -247,5 +257,27 @@ components:
in: header
name: POLY_TIMESTAMP
description: Unix timestamp of the request
polyBuilderApiKey:
type: apiKey
in: header
name: POLY_BUILDER_API_KEY
description: Builder API key for authentication
polyBuilderPassphrase:
type: apiKey
in: header
name: POLY_BUILDER_PASSPHRASE
description: Passphrase for builder authentication
polyBuilderSignature:
type: apiKey
in: header
name: POLY_BUILDER_SIGNATURE
description: HMAC signature for builder authentication
polyBuilderTimestamp:
type: apiKey
in: header
name: POLY_BUILDER_TIMESTAMP
description: Unix timestamp for builder authentication
````
Built with [Mintlify](https://mintlify.com).
+5 -1
View File
@@ -12,7 +12,7 @@ Requires readonly or level 2 API key authentication.
## OpenAPI
````yaml api-spec/clob-openapi.yaml get /trades
````yaml /api-spec/clob-openapi.yaml get /trades
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -38,6 +38,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/trades:
get:
@@ -385,3 +387,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
+33 -1
View File
@@ -5,13 +5,14 @@
# Get user orders
> Retrieves open orders for the authenticated user. Returns paginated results.
Builder-authenticated clients can also use this endpoint to retrieve orders attributed to their builder account.
## OpenAPI
````yaml api-spec/clob-openapi.yaml get /orders
````yaml /api-spec/clob-openapi.yaml get /orders
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -37,6 +38,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/orders:
get:
@@ -46,6 +49,9 @@ paths:
description: >
Retrieves open orders for the authenticated user. Returns paginated
results.
Builder-authenticated clients can also use this endpoint to retrieve
orders attributed to their builder account.
operationId: getOrders
parameters:
- name: id
@@ -154,6 +160,10 @@ paths:
polySignature: []
polyPassphrase: []
polyTimestamp: []
- polyBuilderApiKey: []
polyBuilderPassphrase: []
polyBuilderSignature: []
polyBuilderTimestamp: []
components:
schemas:
OrdersResponse:
@@ -311,5 +321,27 @@ components:
in: header
name: POLY_TIMESTAMP
description: Unix timestamp of the request
polyBuilderApiKey:
type: apiKey
in: header
name: POLY_BUILDER_API_KEY
description: Builder API key for authentication
polyBuilderPassphrase:
type: apiKey
in: header
name: POLY_BUILDER_PASSPHRASE
description: Passphrase for builder authentication
polyBuilderSignature:
type: apiKey
in: header
name: POLY_BUILDER_SIGNATURE
description: HMAC signature for builder authentication
polyBuilderTimestamp:
type: apiKey
in: header
name: POLY_BUILDER_TIMESTAMP
description: Unix timestamp for builder authentication
````
Built with [Mintlify](https://mintlify.com).
+5 -1
View File
@@ -11,7 +11,7 @@
## OpenAPI
````yaml api-spec/clob-openapi.yaml post /order
````yaml /api-spec/clob-openapi.yaml post /order
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -37,6 +37,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/order:
post:
@@ -374,3 +376,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
@@ -12,7 +12,7 @@ Maximum 15 orders per request.
## OpenAPI
````yaml api-spec/clob-openapi.yaml post /orders
````yaml /api-spec/clob-openapi.yaml post /orders
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -38,6 +38,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/orders:
post:
@@ -396,3 +398,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).
+5 -1
View File
@@ -14,7 +14,7 @@ if the system becomes unresponsive.
## OpenAPI
````yaml api-spec/clob-openapi.yaml post /heartbeats
````yaml /api-spec/clob-openapi.yaml post /heartbeats
openapi: 3.1.0
info:
title: Polymarket CLOB API
@@ -40,6 +40,8 @@ tags:
description: User notification endpoints
- name: Rewards
description: Rewards and earnings endpoints
- name: Rebates
description: Maker rebate endpoints
paths:
/heartbeats:
post:
@@ -136,3 +138,5 @@ components:
description: Unix timestamp of the request
````
Built with [Mintlify](https://mintlify.com).