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:
Etherdrake
@@ -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-by-slug.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-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
|
||||
schema:
|
||||
type: boolean
|
||||
default: false
|
||||
responses:
|
||||
'200':
|
||||
description: List of markets
|
||||
@@ -972,10 +973,6 @@ components:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
updatedAt:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
Tag:
|
||||
type: object
|
||||
properties:
|
||||
@@ -1003,10 +1000,6 @@ components:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
updatedAt:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
forceHide:
|
||||
type: boolean
|
||||
nullable: true
|
||||
@@ -1100,10 +1093,6 @@ components:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
updatedAt:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
commentsEnabled:
|
||||
type: boolean
|
||||
nullable: true
|
||||
@@ -1230,10 +1219,6 @@ components:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
updatedAt:
|
||||
type: string
|
||||
format: date-time
|
||||
nullable: true
|
||||
commentsEnabled:
|
||||
type: boolean
|
||||
nullable: true
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
> ## Documentation Index
|
||||
< > ## 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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
<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">
|
||||
* **Fee calculation source**: Fees should now be calculated using the `feeSchedule` object within a market.
|
||||
</Update>
|
||||
@@ -108,7 +112,7 @@
|
||||
</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`
|
||||
* type: string
|
||||
* description: Minimum price increment.
|
||||
@@ -121,7 +125,7 @@
|
||||
</Update>
|
||||
|
||||
<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 label="June 3, 2025" description="Change to /data/trades">
|
||||
@@ -136,7 +140,7 @@
|
||||
</Update>
|
||||
|
||||
<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.
|
||||
* 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
|
||||
</Update>
|
||||
|
||||
|
||||
Built with [Mintlify](https://mintlify.com).
|
||||
|
||||
Reference in New Issue
Block a user