Files
winning-wallet-finder/PolymarketDocumentation-main/docs/api-reference/market-data/get-market-prices-query-parameters.md
T
gavindiaz 125470b24a sync: upstream + our customizations (dashboard, healthcheck, docs)
Synced from github/main: aebcfa2d copybot: live paper feed [skip ci]
Our additions: serve_dashboard.py, bot_dashboard.html, mihomo-healthcheck.sh,
中文文档, 我们的钱包配置
2026-07-21 07:35:48 +08:00

136 lines
3.9 KiB
Markdown

> ## 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 market prices (query parameters)
> Retrieves market prices for multiple token IDs and sides using query parameters.
## OpenAPI
````yaml /api-spec/clob-openapi.yaml get /prices
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:
/prices:
get:
tags:
- Market Data
summary: Get market prices (query parameters)
description: >
Retrieves market prices for multiple token IDs and sides using query
parameters.
operationId: getPricesGet
parameters:
- name: token_ids
in: query
description: Comma-separated list of token IDs
required: true
schema:
type: string
example: 0xabc123...,0xdef456...
- name: sides
in: query
description: >-
Comma-separated list of sides (BUY or SELL) corresponding to token
IDs
required: true
schema:
type: string
example: BUY,SELL
responses:
'200':
description: Successfully retrieved market prices
content:
application/json:
schema:
type: object
additionalProperties:
type: object
additionalProperties:
type: number
format: double
description: Map of token ID to map of side to price
example:
0xabc123def456...:
BUY: 0.45
0xdef456abc123...:
SELL: 0.52
'400':
description: Bad request - Invalid payload or side
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalid_payload:
summary: Invalid payload
value:
error: Invalid payload
invalid_side:
summary: Invalid side
value:
error: Invalid side
'404':
description: Not found - No orderbook exists for the requested token id
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: No orderbook exists for the requested token id
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal server error
security: []
components:
schemas:
ErrorResponse:
type: object
required:
- error
properties:
error:
type: string
description: Error message
code:
type: string
description: Machine-readable error code, when provided
retry_after_seconds:
type: integer
description: Number of seconds to wait before retrying, when provided
````