Skip to main content
POST
/
order
Place Single Order
curl --request POST \
  --url https://poly.drive.markets/order \
  --header 'Content-Type: application/json' \
  --header 'POLY-API-KEY: <poly-api-key>' \
  --header 'POLY-NONCE: <poly-nonce>' \
  --header 'POLY-SIGNATURE: <poly-signature>' \
  --header 'POLY-TIMESTAMP: <poly-timestamp>' \
  --data '
{
  "order": {
    "salt": 123,
    "maker": "<string>",
    "signer": "<string>",
    "taker": "<string>",
    "tokenId": "<string>",
    "makerAmount": "<string>",
    "takerAmount": "<string>",
    "expiration": "<string>",
    "nonce": "<string>",
    "feeRateBps": "<string>",
    "side": "BUY",
    "signatureType": 123,
    "signature": "<string>"
  },
  "owner": "<string>",
  "orderType": "FOK"
}
'
{
  "success": true,
  "errorMsg": "<string>",
  "orderId": "<string>",
  "orderHashes": [
    "<string>"
  ],
  "status": "matched"
}
Polymarket Docs

Headers

​
POLY-API-KEY
string
required

API key of the user

​
POLY-SIGNATURE
string
required

Request signature

​
POLY-TIMESTAMP
string
required

Timestamp of the request

​
POLY-NONCE
string
required

Request nonce

Body

application/json
​
order
object
required
​
owner
string
required

API key of order owner

​
orderType
enum<string>
required

Order type

Available options:
FOK,
GTC,
GTD,
FAK

Response

Order placement response

​
success
boolean

Boolean indicating if server-side error (success = false)

​
errorMsg
string

Error message in case of unsuccessful placement

​
orderId
string

ID of order

​
orderHashes
string[]

Hash of settlement transaction order was marketable and triggered a match

​
status
enum<string>

Status of the order placement

Available options:
matched,
live,
delayed,
unmatched