Skip to main content
POST
/
workflows
/
polymarket
/
placeOrder
Place Order
curl --request POST \
  --url https://api-v2.swaps.xyz/api/workflows/polymarket/placeOrder \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "evmEoa": "0xB9519a08267d7B259eCA6DbD8F7286B1f176A41f",
  "orderRequest": {
    "side": "BUY",
    "tokenID": "90234889617199443673709150877675264662915727532354468551650133547723659310093",
    "orderType": "FOK",
    "tickSize": "0.01",
    "negRisk": true,
    "amount": 5,
    "slippage": 100
  },
  "expiration": 1735689600,
  "signatureByEvmEoa": "0x..."
}
'
{
  "txId": "0xa66c86a47f4f81caae5d767e2d8a5a7def1a191d24eba5bd49f8767297cfe2e5",
  "orderResponse": {
    "success": true,
    "errorMsg": "",
    "orderID": "0xb9826fe87ddf21261eceaf513977cb5ea1ae31ac173210857c879cef936dfa2b",
    "transactionsHashes": [
      "0x39ac6726cf2cfb7814bdb2e04aeeea1d3bde2d1ce7e357f79a404cacb6984f35"
    ],
    "status": "matched",
    "takingAmount": "8.5",
    "makingAmount": "5"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.swaps.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Limited demo key for API Reference: 5c951bc81da566bbd030ba8e20724063.

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