Skip to main content
GET
Get your TraderCode

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.

Response

OK

code
string | null

Your TraderCode — your normalized wallet address (clients render it Monaco - <address>). Always present; the permanent reward identity and a public alias even when a custom handle is set.

Example:

"0x0000000000000000000000000000000000000002"

createdAt
string | null

RFC 3339 timestamp when the code row was first derived

Example:

"2026-07-07T18:00:00Z"

customCode
string | null

Your custom vanity handle, exactly as entered (case preserved), or an empty string when the wallet-derived default is kept. Use is_custom to disambiguate.

Example:

"CryptoKing"

isCustom
boolean | null

True when a custom handle is set; false when the wallet-derived default is in effect.

Example:

true

display
string | null

The single human-facing string to render: the custom handle when set, otherwise the Monaco - <address> default form.

Example:

"CryptoKing"