From 2664984585a5dc03d357dd8e56dcf0efae24050a Mon Sep 17 00:00:00 2001 From: Etherdrake Date: Thu, 9 Apr 2026 17:10:16 +0200 Subject: [PATCH] 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 --- TARGET.md | 1 + .../markets/get-batch-prices-history.md | 140 ++++++++++++++++++ docs/api-reference/markets/list-markets.md | 17 +-- docs/changelog/changelog.md | 13 +- 4 files changed, 150 insertions(+), 21 deletions(-) create mode 100644 docs/api-reference/markets/get-batch-prices-history.md diff --git a/TARGET.md b/TARGET.md index c4e5bf5..3a2575d 100644 --- a/TARGET.md +++ b/TARGET.md @@ -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 diff --git a/docs/api-reference/markets/get-batch-prices-history.md b/docs/api-reference/markets/get-batch-prices-history.md new file mode 100644 index 0000000..651400f --- /dev/null +++ b/docs/api-reference/markets/get-batch-prices-history.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). diff --git a/docs/api-reference/markets/list-markets.md b/docs/api-reference/markets/list-markets.md index 17e0658..e262214 100644 --- a/docs/api-reference/markets/list-markets.md +++ b/docs/api-reference/markets/list-markets.md @@ -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 diff --git a/docs/changelog/changelog.md b/docs/changelog/changelog.md index c25327b..3fa9388 100644 --- a/docs/changelog/changelog.md +++ b/docs/changelog/changelog.md @@ -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. + + * **`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`. + + * **Fee calculation source**: Fees should now be calculated using the `feeSchedule` object within a market. @@ -108,7 +112,7 @@ - * 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 @@ - * 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. @@ -136,7 +140,7 @@ - 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 - Built with [Mintlify](https://mintlify.com).