Skip to main content
GET
Get my fee tier and pair schedule

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.

Query Parameters

tradingPairId
string<uuid>

Trading pair identifier (UUID)

Minimum string length: 1

Response

OK

currentTierLevel
integer<int32> | null

Caller's resolved tier (1–6) from the higher of their wallet's weighted 14-day volume and any volume floor set on the wallet. A floor that is set or changed counts once it applies to the wallet's fills, usually within a minute, and likewise for an account the wallet opens in a new application; a removed or expired floor stops counting at once

Example:

2

weightedVolume14d
string | null

Caller's weighted 14-day volume (perp + 2.5× spot), summed across every application the wallet trades through

Example:

"7500000"

spotVolume14d
string | null

Caller's rolling 14-day spot volume, summed across every application the wallet trades through

Example:

"1000000"

perpVolume14d
string | null

Caller's rolling 14-day perp volume, summed across every application the wallet trades through

Example:

"5000000"

volumeToNextTier
string | null

Additional weighted volume needed to reach the next tier, counted from the volume the current tier resolved from; omitted at tier 6

Example:

"17500000"

nextTierLevel
integer<int32> | null

Next tier level when not already at 6

Example:

3

feeSchedule
object[] | null

Six-row fee schedule for the requested pair, ascending by tier