docs: sync Polymarket docs update 2026-05-28

Updated 45 files across Polymarket Learn (FAQ, deposits, get-started, markets, trading), bridge API, WSS, CLOB status, market makers, and trading/fees sections.
This commit is contained in:
Etherdrake
2026-05-28 18:28:02 +02:00
parent ad523c77c4
commit 3ba658fcb5
45 changed files with 342 additions and 230 deletions
@@ -1,109 +1 @@
> ## 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.
# Create deposit addresses
## OpenAPI
````yaml /api-spec/bridge-openapi.yaml post /deposit
openapi: 3.0.3
info:
title: Polymarket Bridge API
version: 1.0.0
description: HTTP API for Polymarket bridge and swap operations.
servers:
- url: https://bridge.polymarket.com
description: Polymarket Bridge API
security: []
tags:
- name: Bridge
description: Bridge and swap operations for Polymarket
paths:
/deposit:
post:
tags:
- Bridge
summary: Create deposit addresses
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DepositRequest'
example:
address: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
responses:
'201':
description: Deposit addresses created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/DepositResponse'
'400':
description: Bad Request - Invalid address or request body
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
DepositRequest:
type: object
required:
- address
properties:
address:
$ref: '#/components/schemas/Address'
description: >-
Your Polymarket wallet address where deposited funds will be
credited as pUSD
DepositResponse:
type: object
properties:
address:
type: object
description: Deposit addresses for different blockchain networks
properties:
evm:
type: string
description: >-
EVM-compatible deposit address (Ethereum, Polygon, Arbitrum,
Base, etc.)
example: '0x23566f8b2E82aDfCf01846E54899d110e97AC053'
svm:
type: string
description: Solana Virtual Machine deposit address
example: CrvTBvzryYxBHbWu2TiQpcqD5M7Le7iBKzVmEj3f36Jb
btc:
type: string
description: Bitcoin deposit address
example: bc1q8eau83qffxcj8ht4hsjdza3lha9r3egfqysj3g
note:
type: string
description: Additional information about the deposit addresses
example: >-
Only certain chains and tokens are supported. See /supported-assets
for details.
ErrorResponse:
type: object
properties:
error:
type: string
required:
- error
Address:
type: string
description: Ethereum address (0x-prefixed, 40 hex chars)
pattern: ^0x[a-fA-F0-9]{40}$
example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
````
null
@@ -97,25 +97,25 @@ components:
properties:
address:
type: object
description: Deposit addresses for different blockchain networks
description: Bridge addresses for different blockchain networks
properties:
evm:
type: string
description: >-
EVM-compatible deposit address (Ethereum, Polygon, Arbitrum,
EVM-compatible bridge address (Ethereum, Polygon, Arbitrum,
Base, etc.)
example: '0x23566f8b2E82aDfCf01846E54899d110e97AC053'
svm:
type: string
description: Solana Virtual Machine deposit address
description: Solana Virtual Machine bridge address
example: CrvTBvzryYxBHbWu2TiQpcqD5M7Le7iBKzVmEj3f36Jb
btc:
type: string
description: Bitcoin deposit address
description: Bitcoin bridge address
example: bc1q8eau83qffxcj8ht4hsjdza3lha9r3egfqysj3g
note:
type: string
description: Additional information about the deposit addresses
description: Additional information about the bridge addresses
example: >-
Only certain chains and tokens are supported. See /supported-assets
for details.
+78
View File
@@ -45,6 +45,10 @@ operations:
type: array
description: Asset IDs (token IDs) to subscribe to
required: true
properties:
- name: item
type: string
required: false
- name: type
type: string
description: Must be 'market'
@@ -150,6 +154,10 @@ operations:
- name: assets_ids
type: array
required: true
properties:
- name: item
type: string
required: false
- name: level
type: integer
enumValues:
@@ -294,10 +302,28 @@ operations:
type: array
description: Aggregated buy orders by price level
required: true
properties:
- name: price
type: string
description: Price level (e.g., '0.50')
required: true
- name: size
type: string
description: Total size at this price level
required: true
- name: asks
type: array
description: Aggregated sell orders by price level
required: true
properties:
- name: price
type: string
description: Price level (e.g., '0.50')
required: true
- name: size
type: string
description: Total size at this price level
required: true
- name: timestamp
type: string
description: Unix timestamp in milliseconds
@@ -436,6 +462,34 @@ operations:
- name: price_changes
type: array
required: true
properties:
- name: asset_id
type: string
required: true
- name: price
type: string
description: Price level affected
required: true
- name: size
type: string
description: New aggregate size (0 means level removed)
required: true
- name: side
type: string
enumValues:
- BUY
- SELL
required: true
- name: hash
type: string
description: Hash of the order that caused this change
required: true
- name: best_bid
type: string
required: false
- name: best_ask
type: string
required: false
- name: timestamp
type: string
description: Unix timestamp in milliseconds
@@ -861,9 +915,17 @@ operations:
- name: assets_ids
type: array
required: true
properties:
- name: item
type: string
required: false
- name: outcomes
type: array
required: true
properties:
- name: item
type: string
required: false
- name: event_message
type: object
description: Parent event metadata for grouped markets
@@ -890,6 +952,10 @@ operations:
- name: tags
type: array
required: false
properties:
- name: item
type: string
required: false
- name: condition_id
type: string
description: Condition ID
@@ -902,6 +968,10 @@ operations:
type: array
description: CLOB token IDs for the market
required: false
properties:
- name: item
type: string
required: false
- name: sports_market_type
type: string
description: Sports market type such as spread or moneyline
@@ -1113,6 +1183,10 @@ operations:
- name: assets_ids
type: array
required: true
properties:
- name: item
type: string
required: false
- name: winning_asset_id
type: string
required: true
@@ -1145,6 +1219,10 @@ operations:
- name: tags
type: array
required: false
properties:
- name: item
type: string
required: false
headers: []
jsonPayloadSchema:
type: object
+46 -3
View File
@@ -49,15 +49,15 @@ operations:
- name: apiKey
type: string
description: CLOB API key (UUID format)
required: false
required: true
- name: secret
type: string
description: CLOB API secret
required: false
required: true
- name: passphrase
type: string
description: CLOB API passphrase
required: false
required: true
- name: type
type: string
description: Must be 'user'
@@ -68,6 +68,10 @@ operations:
Optional condition IDs to filter events. If omitted, receives
events for all markets.
required: false
properties:
- name: item
type: string
required: false
headers: []
jsonPayloadSchema:
type: object
@@ -155,6 +159,10 @@ operations:
type: array
description: Condition IDs to subscribe to or unsubscribe from
required: true
properties:
- name: item
type: string
required: false
headers: []
jsonPayloadSchema:
type: object
@@ -308,6 +316,10 @@ operations:
type: array
description: Trade IDs this order has been matched in
required: false
properties:
- name: item
type: string
required: false
- name: outcome
type: string
description: e.g. 'YES', 'NO'
@@ -565,6 +577,37 @@ operations:
- name: maker_orders
type: array
required: false
properties:
- name: order_id
type: string
required: true
- name: owner
type: string
required: true
- name: maker_address
type: string
required: false
- name: matched_amount
type: string
required: true
- name: price
type: string
required: true
- name: fee_rate_bps
type: string
required: false
- name: asset_id
type: string
required: true
- name: outcome
type: string
required: false
- name: side
type: string
enumValues:
- BUY
- SELL
required: false
- name: trader_side
type: string
description: Whether the receiving user was TAKER or MAKER