Update Polymarket documentation - April 9, 2026
Changes: - Changelog: Added Apr 9, 2026 entry - GET /markets: closed defaults to false - list-markets.md: Updated to reflect closed=false default on the 'closed' query parameter - New endpoint: Added get-batch-prices-history.md (POST /batch-prices-history) - TARGET.md: Added new get-batch-prices-history.md URL
This commit is contained in:
@@ -184,6 +184,7 @@ https://docs.polymarket.com/api-reference/markets/get-market-by-id.md
|
|||||||
https://docs.polymarket.com/api-reference/markets/get-market-tags-by-id.md
|
https://docs.polymarket.com/api-reference/markets/get-market-tags-by-id.md
|
||||||
https://docs.polymarket.com/api-reference/markets/get-market-by-slug.md
|
https://docs.polymarket.com/api-reference/markets/get-market-by-slug.md
|
||||||
https://docs.polymarket.com/api-reference/markets/get-prices-history.md
|
https://docs.polymarket.com/api-reference/markets/get-prices-history.md
|
||||||
|
https://docs.polymarket.com/api-reference/markets/get-batch-prices-history.md
|
||||||
https://docs.polymarket.com/api-reference/markets/get-sampling-markets.md
|
https://docs.polymarket.com/api-reference/markets/get-sampling-markets.md
|
||||||
https://docs.polymarket.com/api-reference/markets/get-simplified-markets.md
|
https://docs.polymarket.com/api-reference/markets/get-simplified-markets.md
|
||||||
https://docs.polymarket.com/api-reference/markets/get-sampling-simplified-markets.md
|
https://docs.polymarket.com/api-reference/markets/get-sampling-simplified-markets.md
|
||||||
|
|||||||
@@ -0,0 +1,140 @@
|
|||||||
|
< > ## 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.
|
||||||
|
|
||||||
|
# Get batch prices history
|
||||||
|
|
||||||
|
> Retrieve historical price data for multiple markets in a single request.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## OpenAPI
|
||||||
|
|
||||||
|
````yaml /api-spec/clob-openapi.yaml post /batch-prices-history
|
||||||
|
openapi: 3.1.0
|
||||||
|
info:
|
||||||
|
title: Polymarket CLOB API
|
||||||
|
description: Polymarket CLOB API Reference
|
||||||
|
license:
|
||||||
|
name: MIT
|
||||||
|
identifier: MIT
|
||||||
|
version: 1.0.0
|
||||||
|
servers:
|
||||||
|
- url: https://clob.polymarket.com
|
||||||
|
description: Production CLOB API
|
||||||
|
- url: https://clob-staging.polymarket.com
|
||||||
|
description: Staging CLOB API
|
||||||
|
security: []
|
||||||
|
tags:
|
||||||
|
- name: Trade
|
||||||
|
description: Trade endpoints
|
||||||
|
- name: Markets
|
||||||
|
description: Market data endpoints
|
||||||
|
- name: Account
|
||||||
|
description: Account and authentication endpoints
|
||||||
|
- name: Notifications
|
||||||
|
description: User notification endpoints
|
||||||
|
- name: Rewards
|
||||||
|
description: Rewards and earnings endpoints
|
||||||
|
- name: Rebates
|
||||||
|
description: Maker rebate endpoints
|
||||||
|
paths:
|
||||||
|
/batch-prices-history:
|
||||||
|
post:
|
||||||
|
tags:
|
||||||
|
- Markets
|
||||||
|
summary: Get batch prices history
|
||||||
|
description: Retrieve historical price data for multiple markets in a single request.
|
||||||
|
operationId: getBatchPricesHistory
|
||||||
|
requestBody:
|
||||||
|
required: true
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/BatchPricesHistoryRequest'
|
||||||
|
responses:
|
||||||
|
'200':
|
||||||
|
description: Successful response with price history for each market
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/BatchPricesHistoryResponse'
|
||||||
|
'400':
|
||||||
|
description: Bad Request - Missing or invalid parameters
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
'500':
|
||||||
|
description: Internal server error
|
||||||
|
content:
|
||||||
|
application/json:
|
||||||
|
schema:
|
||||||
|
$ref: '#/components/schemas/ErrorResponse'
|
||||||
|
security: []
|
||||||
|
components:
|
||||||
|
schemas:
|
||||||
|
BatchPricesHistoryRequest:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- markets
|
||||||
|
properties:
|
||||||
|
markets:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
type: string
|
||||||
|
description: List of market asset ids to query. Maximum 20.
|
||||||
|
maxItems: 20
|
||||||
|
start_ts:
|
||||||
|
type: number
|
||||||
|
format: double
|
||||||
|
description: Filter by items after this unix timestamp (seconds).
|
||||||
|
end_ts:
|
||||||
|
type: number
|
||||||
|
format: double
|
||||||
|
description: Filter by items before this unix timestamp (seconds).
|
||||||
|
interval:
|
||||||
|
type: string
|
||||||
|
enum:
|
||||||
|
- max
|
||||||
|
- all
|
||||||
|
- 1m
|
||||||
|
- 1w
|
||||||
|
- 1d
|
||||||
|
- 6h
|
||||||
|
- 1h
|
||||||
|
description: Time interval for data aggregation.
|
||||||
|
fidelity:
|
||||||
|
type: integer
|
||||||
|
description: Accuracy of the data expressed in minutes. Default is 1 minute.
|
||||||
|
BatchPricesHistoryResponse:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
history:
|
||||||
|
type: object
|
||||||
|
additionalProperties:
|
||||||
|
type: array
|
||||||
|
items:
|
||||||
|
$ref: '#/components/schemas/MarketPrice'
|
||||||
|
description: Map of market asset id to array of price data points.
|
||||||
|
ErrorResponse:
|
||||||
|
type: object
|
||||||
|
required:
|
||||||
|
- error
|
||||||
|
properties:
|
||||||
|
error:
|
||||||
|
type: string
|
||||||
|
description: Error message
|
||||||
|
MarketPrice:
|
||||||
|
type: object
|
||||||
|
properties:
|
||||||
|
t:
|
||||||
|
type: integer
|
||||||
|
format: uint32
|
||||||
|
p:
|
||||||
|
type: number
|
||||||
|
format: float
|
||||||
|
|
||||||
|
````
|
||||||
|
|
||||||
|
Built with [Mintlify](https://mintlify.com).
|
||||||
@@ -159,6 +159,7 @@ paths:
|
|||||||
in: query
|
in: query
|
||||||
schema:
|
schema:
|
||||||
type: boolean
|
type: boolean
|
||||||
|
default: false
|
||||||
responses:
|
responses:
|
||||||
'200':
|
'200':
|
||||||
description: List of markets
|
description: List of markets
|
||||||
@@ -972,10 +973,6 @@ components:
|
|||||||
type: string
|
type: string
|
||||||
format: date-time
|
format: date-time
|
||||||
nullable: true
|
nullable: true
|
||||||
updatedAt:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
nullable: true
|
|
||||||
Tag:
|
Tag:
|
||||||
type: object
|
type: object
|
||||||
properties:
|
properties:
|
||||||
@@ -1003,10 +1000,6 @@ components:
|
|||||||
type: string
|
type: string
|
||||||
format: date-time
|
format: date-time
|
||||||
nullable: true
|
nullable: true
|
||||||
updatedAt:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
nullable: true
|
|
||||||
forceHide:
|
forceHide:
|
||||||
type: boolean
|
type: boolean
|
||||||
nullable: true
|
nullable: true
|
||||||
@@ -1100,10 +1093,6 @@ components:
|
|||||||
type: string
|
type: string
|
||||||
format: date-time
|
format: date-time
|
||||||
nullable: true
|
nullable: true
|
||||||
updatedAt:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
nullable: true
|
|
||||||
commentsEnabled:
|
commentsEnabled:
|
||||||
type: boolean
|
type: boolean
|
||||||
nullable: true
|
nullable: true
|
||||||
@@ -1230,10 +1219,6 @@ components:
|
|||||||
type: string
|
type: string
|
||||||
format: date-time
|
format: date-time
|
||||||
nullable: true
|
nullable: true
|
||||||
updatedAt:
|
|
||||||
type: string
|
|
||||||
format: date-time
|
|
||||||
nullable: true
|
|
||||||
commentsEnabled:
|
commentsEnabled:
|
||||||
type: boolean
|
type: boolean
|
||||||
nullable: true
|
nullable: true
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
> ## Documentation Index
|
< > ## Documentation Index
|
||||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||||
> Use this file to discover all available pages before exploring further.
|
> Use this file to discover all available pages before exploring further.
|
||||||
|
|
||||||
@@ -6,6 +6,10 @@
|
|||||||
|
|
||||||
> 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.
|
> 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.
|
||||||
|
|
||||||
|
<Update label="Apr 9, 2026" description="GET /markets: closed defaults to false">
|
||||||
|
* **`closed` default change**: The `closed` query parameter on `GET /markets` now defaults to `false`. Closed markets are excluded from results unless you explicitly pass `closed=true`.
|
||||||
|
</Update>
|
||||||
|
|
||||||
<Update label="Mar 31, 2026" description="REST API Fee Fields Update">
|
<Update label="Mar 31, 2026" description="REST API Fee Fields Update">
|
||||||
* **Fee calculation source**: Fees should now be calculated using the `feeSchedule` object within a market.
|
* **Fee calculation source**: Fees should now be calculated using the `feeSchedule` object within a market.
|
||||||
</Update>
|
</Update>
|
||||||
@@ -108,7 +112,7 @@
|
|||||||
</Update>
|
</Update>
|
||||||
|
|
||||||
<Update label="July 23, 2025" description="Get Book(s) update">
|
<Update label="July 23, 2025" description="Get Book(s) update">
|
||||||
* We’re adding new fields to the `get-book` and `get-books` CLOB endpoints to include key market metadata that previously required separate queries.
|
* We're adding new fields to the `get-book` and `get-books` CLOB endpoints to include key market metadata that previously required separate queries.
|
||||||
* `min_order_size`
|
* `min_order_size`
|
||||||
* type: string
|
* type: string
|
||||||
* description: Minimum price increment.
|
* description: Minimum price increment.
|
||||||
@@ -121,7 +125,7 @@
|
|||||||
</Update>
|
</Update>
|
||||||
|
|
||||||
<Update label="June 3, 2025" description="New Batch Orders Endpoint">
|
<Update label="June 3, 2025" description="New Batch Orders Endpoint">
|
||||||
* 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 [Create Orders](/trading/orders/create) for more details.
|
* 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 [Create Orders](/trading/orders/create) for more details.
|
||||||
</Update>
|
</Update>
|
||||||
|
|
||||||
<Update label="June 3, 2025" description="Change to /data/trades">
|
<Update label="June 3, 2025" description="Change to /data/trades">
|
||||||
@@ -136,7 +140,7 @@
|
|||||||
</Update>
|
</Update>
|
||||||
|
|
||||||
<Update label="May 28, 2025" description="New FAK Order Type">
|
<Update label="May 28, 2025" description="New FAK Order Type">
|
||||||
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 Kill (FOK) orders, but with a key difference:
|
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 Kill (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.
|
* 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.
|
* 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.
|
||||||
@@ -155,5 +159,4 @@
|
|||||||
* DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate
|
* DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate
|
||||||
</Update>
|
</Update>
|
||||||
|
|
||||||
|
|
||||||
Built with [Mintlify](https://mintlify.com).
|
Built with [Mintlify](https://mintlify.com).
|
||||||
|
|||||||
Reference in New Issue
Block a user