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.

Body

application/json
subaccountKey
string | null

Sub-account key: up to 64 letters, digits, _, -, . or :. Keys starting with copy: are reserved, and default names the default margin account.

label
string | null

Optional display label.

Response

OK

marginAccountId
string | null
subaccountKey
string | null
marginAccountState
string | null

Values: ACTIVE.

label
string | null