Sign in

v1

latestOpenAPI 3.1.02026-07-262771117.8 KB
Polymarket

Place Order

Places a market order (BUY or SELL) directly against the Polymarket CLOB on behalf of the user, using their pre-funded proxy wallet.

This endpoint always requires an EIP-712 signatureByEvmEoa produced by the user's EOA — see the Polymarket Signing Guide. The endpoint submits the order synchronously and returns { txId, orderResponse } so callers can poll workflow status.

post/workflows/polymarket/placeOrder

Request body

evmEoastring required

EVM address (0x prefix + 40 hex characters)

proxyWalletstring

EVM address (0x prefix + 40 hex characters)

expirationinteger required

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

signatureByEvmEoastring required

Hex string with 0x prefix

Example request

{
  "evmEoa": "0xB9519a08267d7B259eCA6DbD8F7286B1f176A41f",
  "orderRequest": {
    "side": "BUY",
    "tokenID": "90234889617199443673709150877675264662915727532354468551650133547723659310093",
    "orderType": "FOK",
    "tickSize": "0.01",
    "negRisk": true,
    "amount": 5,
    "slippage": 100
  },
  "expiration": 1735689600,
  "signatureByEvmEoa": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890001b"
}

Response

Order placed successfully

txIdstring

Box transaction ID for the order workflow

Example response

{
  "txId": "0xa66c86a47f4f81caae5d767e2d8a5a7def1a191d24eba5bd49f8767297cfe2e5",
  "orderResponse": {
    "success": true,
    "errorMsg": "",
    "orderID": "0xb9826fe87ddf21261eceaf513977cb5ea1ae31ac173210857c879cef936dfa2b",
    "transactionsHashes": [
      "0x39ac6726cf2cfb7814bdb2e04aeeea1d3bde2d1ce7e357f79a404cacb6984f35"
    ],
    "status": "matched",
    "takingAmount": "8.5",
    "makingAmount": "5"
  }
}