Skip to main content
POST
Place Order

Authorizations

x-api-key
string
header
required

API key for authentication. Contact Swaps.xyz to obtain an API key.

Body

application/json
evmEoa
string
required

User's EVM wallet address

Pattern: ^0x[a-fA-F0-9]{40}$
orderRequest
object
required
expiration
integer
required

Unix timestamp (seconds) when signatureByEvmEoa expires. Must be in the future and ≤ 300s ahead.

signatureByEvmEoa
string
required

EIP-712 signature by the EOA over the PlaceOrder typed data. See the Polymarket Signing Guide.

Pattern: ^0x[a-fA-F0-9]*$
proxyWallet
string

Proxy wallet address (optional)

Pattern: ^0x[a-fA-F0-9]{40}$

Response

Order placed successfully

txId
string

Box transaction ID for the order workflow

orderResponse
object