POST
cURL
This operation serves spot markets only. Send a spot symbol in the BASE/QUOTE format. Read Which symbol format.

Authorizations

Authorization
string
header
required

The authorization field takes the session bearer returned by sign-in, or an API key where the route allows keys. Paste the token itself into the authorization field. When invitation-only access is enabled, private operations require the account's sign-in email to be invited. Sign-in can complete without an invitation, but private HTTP, MCP and FIX operations refuse with access_not_allowlisted (HTTP 403): "Private access is limited to invited accounts. Contact support to request access." Public market data remains available. Invitation changes apply to the next private operation, including existing FIX sessions. Do not retry until support confirms access.

Headers

Idempotency-Key
string
required
Minimum string length: 1

Body

application/json
symbol
string
required
Minimum string length: 1
side
enum<string>
required
Available options:
buy,
sell
amount
number
required

The total base amount of the TWAP.

duration
integer
required

The running time in MILLISECONDS (createTwapOrder), from 300000 (5 minutes) to 604800000 (7 days). One slice is sent each 30000.

params
object

Response

Success

id
string
required
Pattern: ^po_[0-9a-f]{32}$
clientOrderId
string
required

1 to 256 ASCII letters, digits, periods, underscores, colons or hyphens. Canonical bot identifiers also allow the fixed bot-order/v1: prefix followed by an optional sha256: marker and 64 lowercase hexadecimal digits.

Required string length: 1 - 256
Pattern: ^(?:[A-Za-z0-9._:-]+|bot-order\/v1:(?:sha256:)?[a-f0-9]{64})$
symbol
string
required
Pattern: ^([^/:]+)\/([^/:]+)$
timestamp
integer
required
Required range: x >= 0
datetime
string
required
lastTradeTimestamp
null
required
lastUpdateTimestamp
integer
required
Required range: x >= 0
status
enum<string>
required
Available options:
open,
closed,
canceled,
expired,
rejected
side
enum<string>
required
Available options:
buy,
sell
type
string
required
Allowed value: "twap"
price
number | null
required

The limit price, or null without one.

amount
number
required
filled
number
required
Required range: x >= 0
remaining
number
required
Required range: x >= 0
cost
number
required

Filled notional in the quote asset.

Required range: x >= 0
postOnly
boolean
required
reduceOnly
boolean
required
trades
object[]
required

Empty: the child fills read through fetchMyTrades.

fee
null
required
info
object
required
average
number