Skip to main content
POST
cURL

Authorizations

X-Monaco-Signature
string
header
required

Ed25519 session-key request signing. Every authenticated request carries three headers: X-Monaco-PublicKey (64-char lowercase-hex session public key), X-Monaco-Timestamp (Unix milliseconds, within 30s of server time), and X-Monaco-Signature (hex ed25519 signature). The signature is over METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body), where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from POST /api/v1/auth/challenge followed by POST /api/v1/auth/verify.

Path Parameters

positionId
string
default:2b1a5f9c-0000-4000-8000-000000000002
required

Body

application/json
trailingStop
object | null

Trailing stop (0XM-2827). May be attached alone or alongside take_profit / stop_loss; it never takes part in oco and coexists with fixed legs.

takeProfit
object
stopLoss
object
oco
boolean | null

One-cancels-the-other. Defaults to false. When true, both take_profit and stop_loss are required and the sibling is cancelled after either triggers.

Response

OK

positionId
string | null
takeProfitOrderId
string | null
stopLossOrderId
string | null
status
string | null
message
string | null
trailingStopOrderId
string | null