Skip to main content
POST
/
v1
/
orders
Create order
curl --request POST \
  --url https://api.polymarket.us/v1/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "market_slug": "<string>",
  "intent": 1,
  "type": 1,
  "price": {
    "value": "0.55",
    "currency": "USD"
  },
  "quantity": 123,
  "tif": 1,
  "participateDontInitiate": true,
  "goodTillTime": "<string>",
  "cashOrderQty": {
    "value": "0.55",
    "currency": "USD"
  },
  "manualOrderIndicator": 1,
  "synchronousExecution": true,
  "maxBlockTime": "<string>"
}
'
{
  "id": "<string>",
  "executions": [
    {
      "id": "<string>",
      "order": {
        "id": "<string>",
        "market_slug": "<string>",
        "side": 1,
        "type": 1,
        "price": {
          "value": "0.55",
          "currency": "USD"
        },
        "quantity": 123,
        "cumQuantity": 123,
        "leavesQuantity": 123,
        "tif": 1,
        "goodTillTime": "2023-11-07T05:31:56Z",
        "intent": 1,
        "marketMetadata": {
          "slug": "<string>",
          "icon": "<string>",
          "title": "<string>",
          "outcome": "<string>",
          "eventSlug": "<string>"
        },
        "state": 123,
        "avgPx": {
          "value": "0.55",
          "currency": "USD"
        },
        "insertTime": "2023-11-07T05:31:56Z",
        "createTime": "2023-11-07T05:31:56Z"
      },
      "lastShares": "<string>",
      "lastPx": {
        "value": "0.55",
        "currency": "USD"
      },
      "type": 123,
      "text": "<string>",
      "orderRejectReason": 123,
      "transactTime": "2023-11-07T05:31:56Z",
      "tradeId": "<string>",
      "aggressor": true
    }
  ]
}

Body

application/json

Request to create a new order

​
market_slug
string
required

Market slug to place order in

​
intent
enum<integer>
required

Intent of the order: 1 = BUY_YES, 2 = SELL_YES, 3 = BUY_NO, 4 = SELL_NO

Available options:
1,
2,
3,
4
​
type
enum<integer>

Type of order: 1 = LIMIT, 2 = MARKET

Available options:
1,
2
​
price
object

Order price (required for limit orders)

​
quantity
number<double>

Order quantity in shares

​
tif
enum<integer>

Time in force: 1 = GTC (Good Till Cancel), 2 = GTD (Good Till Date), 3 = IOC (Immediate or Cancel), 4 = FOK (Fill or Kill)

Available options:
1,
2,
3,
4
​
participateDontInitiate
boolean

If true, order must rest on book (maker only)

​
goodTillTime
string

Expiration time for GTD orders

​
cashOrderQty
object

Order quantity in cash (for market orders)

​
manualOrderIndicator
enum<integer>

Indicates whether the order was placed manually or automatically: 1 = MANUAL, 2 = AUTOMATIC

Available options:
1,
2
​
synchronousExecution
boolean

If true, wait for order execution before returning

​
maxBlockTime
string<int64>

Max wait time in seconds for synchronous execution

Response

Order created successfully

​
id
string

Created order ID

​
executions
object[]

Executions if synchronous execution was requested