Kuest Docs

Post A New Order

Create a new order

Get Help
POST
/order

Header Parameters

KUEST_ADDRESS*string

Checksummed wallet address performing the request.

KUEST_API_KEY*string

API key obtained from the L1 derivation endpoint.

Formatuuid
KUEST_PASSPHRASE*string

64 character hexadecimal passphrase associated with the API key.

KUEST_TIMESTAMP*string

Millisecond epoch timestamp (string) used for freshness checks.

KUEST_SIGNATURE*string

Base64url-encoded HMAC-SHA256 signature built from timestamp + method + path (+ body), where path excludes any query string.

Request Body

application/json
  1. body
order*
orderType*string

Time-in-force policy for the order.

Value in"FOK""FAK""GTC""GTD"
postOnly?boolean

When true, the order must rest on the book (GTC/GTD only).

Defaultfalse
owner*string

API key owner issuing the request.

Response Body

Order placement result

application/json
  1. response
success*boolean

Indicates whether the order was accepted.

errorMsg*string

Human-readable status for the placement.

orderID*string

Order identifier when accepted.

takingAmount*string

Taker amount reported by the placement engine (empty when not provided).

makingAmount*string

Maker amount reported by the placement engine (empty when not provided).

status*string

Placement status. pending_settlement means the order matched off-chain and awaits on-chain confirmation.

Value in"live""matched""unmatched""pending_settlement""error"
orderHash?|

Canonical EIP-712 order hash. orderID remains the internal engine order identifier.

code?|

Stable machine-readable error code when the placement failed.

retry_after_seconds?|

Number of seconds to wait before retrying this placement, when provided.

Formatint64
Range1 <= value
curl -X POST 'https://clob.kuest.com/order' \  -H 'KUEST_ADDRESS: string' \  -H 'KUEST_API_KEY: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'KUEST_PASSPHRASE: string' \  -H 'KUEST_TIMESTAMP: string' \  -H 'KUEST_SIGNATURE: string' \  -H 'Content-Type: application/json' \  -d '{  "order": {    "tokenId": "string",    "conditionId": "string",    "maker": "string",    "signer": "string",    "makerAmount": "string",    "takerAmount": "string",    "side": "BUY",    "metadata": "string",    "builder": "string",    "timestamp": "string",    "salt": "string",    "signatureType": 3,    "signature": "string"  },  "orderType": "FOK",  "owner": "string"}'
{  "success": true,  "errorMsg": "string",  "orderID": "string",  "takingAmount": "string",  "makingAmount": "string",  "status": "live",  "orderHash": "string",  "code": "string",  "retry_after_seconds": 1}