docs: sync with official Polymarket docs - 2026-04-20

This commit is contained in:
Etherdrake
2026-04-20 01:19:37 +02:00
parent 3ad0048c35
commit ff4882db02
50 changed files with 705 additions and 1857 deletions
+22 -16
View File
@@ -171,10 +171,11 @@ paths:
example:
error: could not fetch builder trades
security:
- polyBuilderApiKey: []
polyBuilderPassphrase: []
polyBuilderSignature: []
polyBuilderTimestamp: []
- polyApiKey: []
polyAddress: []
polySignature: []
polyPassphrase: []
polyTimestamp: []
components:
schemas:
BuilderTradesResponse:
@@ -342,25 +343,30 @@ components:
description: Last update timestamp
example: '2024-01-01T00:00:00Z'
securitySchemes:
polyBuilderApiKey:
polyApiKey:
type: apiKey
in: header
name: POLY_BUILDER_API_KEY
description: Builder API key for authentication
polyBuilderPassphrase:
name: POLY_API_KEY
description: Your API key
polyAddress:
type: apiKey
in: header
name: POLY_BUILDER_PASSPHRASE
description: Passphrase for builder authentication
polyBuilderSignature:
name: POLY_ADDRESS
description: Ethereum address associated with the API key
polySignature:
type: apiKey
in: header
name: POLY_BUILDER_SIGNATURE
description: HMAC signature for builder authentication
polyBuilderTimestamp:
name: POLY_SIGNATURE
description: HMAC signature of the request
polyPassphrase:
type: apiKey
in: header
name: POLY_BUILDER_TIMESTAMP
description: Unix timestamp for builder authentication
name: POLY_PASSPHRASE
description: API key passphrase
polyTimestamp:
type: apiKey
in: header
name: POLY_TIMESTAMP
description: Unix timestamp of the request
````
@@ -123,10 +123,6 @@ paths:
polySignature: []
polyPassphrase: []
polyTimestamp: []
- polyBuilderApiKey: []
polyBuilderPassphrase: []
polyBuilderSignature: []
polyBuilderTimestamp: []
components:
schemas:
OpenOrder:
@@ -257,25 +253,5 @@ components:
in: header
name: POLY_TIMESTAMP
description: Unix timestamp of the request
polyBuilderApiKey:
type: apiKey
in: header
name: POLY_BUILDER_API_KEY
description: Builder API key for authentication
polyBuilderPassphrase:
type: apiKey
in: header
name: POLY_BUILDER_PASSPHRASE
description: Passphrase for builder authentication
polyBuilderSignature:
type: apiKey
in: header
name: POLY_BUILDER_SIGNATURE
description: HMAC signature for builder authentication
polyBuilderTimestamp:
type: apiKey
in: header
name: POLY_BUILDER_TIMESTAMP
description: Unix timestamp for builder authentication
````
@@ -160,10 +160,6 @@ paths:
polySignature: []
polyPassphrase: []
polyTimestamp: []
- polyBuilderApiKey: []
polyBuilderPassphrase: []
polyBuilderSignature: []
polyBuilderTimestamp: []
components:
schemas:
OrdersResponse:
@@ -321,25 +317,5 @@ components:
in: header
name: POLY_TIMESTAMP
description: Unix timestamp of the request
polyBuilderApiKey:
type: apiKey
in: header
name: POLY_BUILDER_API_KEY
description: Builder API key for authentication
polyBuilderPassphrase:
type: apiKey
in: header
name: POLY_BUILDER_PASSPHRASE
description: Passphrase for builder authentication
polyBuilderSignature:
type: apiKey
in: header
name: POLY_BUILDER_SIGNATURE
description: HMAC signature for builder authentication
polyBuilderTimestamp:
type: apiKey
in: header
name: POLY_BUILDER_TIMESTAMP
description: Unix timestamp for builder authentication
````
+20 -16
View File
@@ -61,14 +61,15 @@ paths:
order:
maker: '0x1234567890123456789012345678901234567890'
signer: '0x1234567890123456789012345678901234567890'
taker: '0x0000000000000000000000000000000000000000'
tokenId: 0xabc123def456...
makerAmount: '100000000'
takerAmount: '200000000'
side: BUY
expiration: '1735689600'
nonce: '0'
feeRateBps: '30'
timestamp: '1735689600000'
metadata: ''
builder: >-
0x0000000000000000000000000000000000000000000000000000000000000000
signature: 0x1234abcd...
salt: 1234567890
signatureType: 0
@@ -276,14 +277,13 @@ components:
required:
- maker
- signer
- taker
- tokenId
- makerAmount
- takerAmount
- side
- expiration
- nonce
- feeRateBps
- timestamp
- builder
- signature
- salt
- signatureType
@@ -298,10 +298,6 @@ components:
type: string
description: Ethereum address of the signer
example: '0x1234567890123456789012345678901234567890'
taker:
type: string
description: Ethereum address of the taker (0x0 for open orders)
example: '0x0000000000000000000000000000000000000000'
tokenId:
type: string
description: Token ID (asset ID) for the order
@@ -325,14 +321,22 @@ components:
type: string
description: Unix timestamp when the order expires
example: '1735689600'
nonce:
timestamp:
type: string
description: Order nonce
example: '0'
feeRateBps:
description: >-
Unix timestamp in milliseconds when the order was created (used for
order uniqueness)
example: '1735689600000'
metadata:
type: string
description: Fee rate in basis points
example: '30'
description: Reserved for future use
example: ''
builder:
type: string
description: >-
Builder code (bytes32) for integrator attribution. `0x` + 64 hex
chars or empty.
example: '0x0000000000000000000000000000000000000000000000000000000000000000'
signature:
type: string
description: Cryptographic signature of the order
@@ -68,14 +68,15 @@ paths:
- order:
maker: '0x1234567890123456789012345678901234567890'
signer: '0x1234567890123456789012345678901234567890'
taker: '0x0000000000000000000000000000000000000000'
tokenId: 0xabc123def456...
makerAmount: '100000000'
takerAmount: '200000000'
side: BUY
expiration: '1735689600'
nonce: '0'
feeRateBps: '30'
timestamp: '1735689600000'
metadata: ''
builder: >-
0x0000000000000000000000000000000000000000000000000000000000000000
signature: 0x1234abcd...
salt: 1234567890
signatureType: 0
@@ -85,14 +86,15 @@ paths:
- order:
maker: '0x1234567890123456789012345678901234567890'
signer: '0x1234567890123456789012345678901234567890'
taker: '0x0000000000000000000000000000000000000000'
tokenId: 0xdef456abc789...
makerAmount: '200000000'
takerAmount: '100000000'
side: SELL
expiration: '1735689600'
nonce: '0'
feeRateBps: '30'
timestamp: '1735689600000'
metadata: ''
builder: >-
0x0000000000000000000000000000000000000000000000000000000000000000
signature: 0x5678efgh...
salt: 1234567891
signatureType: 0
@@ -298,14 +300,13 @@ components:
required:
- maker
- signer
- taker
- tokenId
- makerAmount
- takerAmount
- side
- expiration
- nonce
- feeRateBps
- timestamp
- builder
- signature
- salt
- signatureType
@@ -320,10 +321,6 @@ components:
type: string
description: Ethereum address of the signer
example: '0x1234567890123456789012345678901234567890'
taker:
type: string
description: Ethereum address of the taker (0x0 for open orders)
example: '0x0000000000000000000000000000000000000000'
tokenId:
type: string
description: Token ID (asset ID) for the order
@@ -347,14 +344,22 @@ components:
type: string
description: Unix timestamp when the order expires
example: '1735689600'
nonce:
timestamp:
type: string
description: Order nonce
example: '0'
feeRateBps:
description: >-
Unix timestamp in milliseconds when the order was created (used for
order uniqueness)
example: '1735689600000'
metadata:
type: string
description: Fee rate in basis points
example: '30'
description: Reserved for future use
example: ''
builder:
type: string
description: >-
Builder code (bytes32) for integrator attribution. `0x` + 64 hex
chars or empty.
example: '0x0000000000000000000000000000000000000000000000000000000000000000'
signature:
type: string
description: Cryptographic signature of the order