Skip to main content
PUT
Set your self-trade-prevention default

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.

Body

application/json
mode
string
required

The self-trade-prevention mode applied when an order from this wallet would match the wallet family's own resting order and the order names no override: CANCEL_MAKER (cancel the resting order — the platform default), CANCEL_TAKER (cancel the incoming order), CANCEL_BOTH, or SKIP (trade around own orders). Input is case-insensitive.

Example:

"SKIP"

Response

OK

mode
string | null

The wallet's effective self-trade-prevention default: CANCEL_MAKER, CANCEL_TAKER, CANCEL_BOTH, or SKIP.

Example:

"CANCEL_MAKER"

isCustom
boolean | null

True when this wallet has explicitly set a default; false when the platform default (CANCEL_MAKER) is in effect.

Example:

false