Skip to main content
GET
Get faucet quota and recent requests

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

remainingRequests24h
integer<uint32> | null

Remaining faucet requests in the rolling 24h window

Example:

2

dailyLimit
integer<uint32> | null

Maximum faucet requests per rolling 24h window

Example:

3

nextAvailableAt
string | null

Timestamp (ISO 8601) safe to retry at or after: when the wallet's next faucet slot frees under the current daily limit, with a small safety margin. When remaining_requests_24h is 0 this is when the next mint becomes possible. Absent when no requests are in the rolling 24h window or when the daily limit is 0. Not a calendar-day reset.

recentRequests
object[] | null

Up to 5 most recent faucet request groups, newest first, regardless of the 24h window.