Skip to main content
POST
Mint one Mainnet invite code

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

The body is of type object.

Response

OK

mainnetVolumeUsd
string | null

Executed Mainnet USDC quote notional since the configured production launch, counting maker and taker wallets at 1 USDC = 1 USD. Zero until volume rewards and the launch timestamp are configured.

Example:

"250000.00"

eligibleMilestones
integer<int32> | null

Number of completed Mainnet volume milestones of 250,000 USDC each.

Example:

1

pendingMilestones
integer<int32>[] | null

Previously pending milestones, retained for compatibility. Self-service minting creates an issued code immediately.

Example:
issuedMilestones
integer<int32>[] | null

Issued allowance slots. Slot 0 is the initial code; slot N is the Nth 250,000 USDC volume milestone.

Example:
redeemedMilestones
integer<int32>[] | null

Milestones whose issued code has been redeemed.

Example:
newlyRequestedMilestones
integer<int32>[] | null

The single allowance slot minted by this call, or an empty array when no allowance remains. Every call may consume the next available slot.

Example:
code
string | null

The newly minted 10-character case-sensitive bearer code. Absent when no allowance remains. Store securely; never log it.

codeId
string | null

Identifier of the newly minted code; absent when no allowance remains.

mintedMilestone
integer<int32> | null

Consumed allowance slot: 0 for the initial code, N for the Nth 250,000 USDC milestone.

totalAllowance
integer<int32> | null

One initial code plus the number of completed Mainnet volume milestones of 250,000 USDC each.

availableCodes
integer<int32> | null

Unconsumed allowance after this call. Revoked slots remain consumed.

revokedMilestones
integer<int32>[] | null

Revoked allowance slots; they cannot be minted again.