Skip to main content
GET
Resolve a user's builder fee

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

walletAddress
string
tradingPairId
string<uuid>

Trading pair identifier (UUID)

Minimum string length: 1
track
string

Response

OK

makerCbps
integer<int32> | null

The maker add-on this order is charged now, after the cap and every switch, in centi-bps.

Required range: x <= 10000
Example:

150

takerCbps
integer<int32> | null

The taker add-on this order is charged now, after the cap and every switch, in centi-bps.

Required range: x <= 10000
Example:

250

makerClamped
boolean | null

The winning rule's maker add-on is above the cap, so the cap is charged.

takerClamped
boolean | null

The winning rule's taker add-on is above the cap, so the cap is charged.

builderFeeEnabled
boolean | null

Whether a builder fee is charged on this application's orders at all. False when builder fees are switched off for it or it is not enrolled with a payout address; nothing is charged then.

capCbps
integer<int32> | null

The cap on each side for this order, in centi-bps.

Required range: x <= 10000
Example:

10000

revshareBps
integer<int32> | null

The BuilderCodes revenue share for this order, in basis points.

Required range: x <= 10000
Example:

1000

winningRule
object
matchingRules
object[] | null

Every add-on rule that matches this order, the winner first: Monaco's overrides, then yours, each most specific first.

winningCap
object
winningRevshare
object