Pay 1 USDC on Base to mint a mystery reward token with chances for refunds and jackpots.
What it does
LuckyMint is an x402-enabled endpoint on Base mainnet that lets callers pay 1 USDC per spin to mint a mystery reward token. Each mint has a chance to trigger a bonus USDC refund or win the entire jackpot pool (currently ~$38 USDC accumulated from previous plays). Results are described as provably fair, using a random seed returned in the response. The token has a total supply of 10 million, of which roughly 110 have been minted so far.
The endpoint accepts POST requests and returns a JSON response indicating whether the mint succeeded, the on-chain transaction hash, the number of tokens received, whether a refund was granted, whether the jackpot was won (and the amount if so), a unique mint ID, and the random seed used. Payment is handled via the x402 protocol: callers must include an X-PAYMENT header with a valid payment proof for 1 USDC (maxAmountRequired of 1,000,000 base units on USDC's 6-decimal scale) sent to the specified payTo address on Base.
No formal API documentation, OpenAPI spec, or pricing page exists beyond the landing page and the x402 challenge itself. The endpoint is live and returns a proper 402 challenge. It is also described as a Farcaster mini-app, suggesting integration with the Farcaster social protocol ecosystem.
Capabilities
Use cases
- —Agents autonomously participating in on-chain lottery/raffle mechanics
- —Programmatic minting of reward tokens with randomized outcomes
- —Building gamified experiences on top of x402 payment flows
- —Farcaster mini-app integrations for social gaming
Fit
Best for
- —AI agents or bots that want to autonomously play on-chain lottery games
- —Developers exploring x402 payment protocol integrations on Base
- —Farcaster ecosystem builders adding gamified token minting
Not for
- —Users seeking deterministic or guaranteed-value token purchases
- —Applications requiring detailed API documentation or SLA guarantees
- —High-volume production systems needing rate-limit and error-handling docs
Quick start
curl -X POST https://www.luckymint.xyz/api/mint \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_proof>"Example
Response
{
"seed": "0x9f8e7d...1a2b3c",
"mintId": 111,
"tokens": "1",
"success": true,
"refunded": false,
"jackpotWon": false,
"jackpotAmount": "0",
"transactionHash": "0xabc123...def456"
}Endpoint
Quality
The x402 challenge is live and includes a clear output schema with field descriptions. The landing page provides basic gameplay mechanics and stats. However, there is no formal API documentation, no OpenAPI spec, no error handling docs, and no detailed pricing page beyond what the challenge and landing page convey.
Warnings
- —No formal API documentation exists (/docs returns 404)
- —No OpenAPI or machine-readable spec provided
- —Jackpot and refund probabilities are not documented anywhere
- —This is a gambling/lottery-style endpoint — regulatory considerations may apply
- —Very low usage so far (110 plays, 0 jackpots won)
Citations
- —Price is 1 USDC per spinhttps://www.luckymint.xyz
- —Jackpot pool is currently ~$38 USDChttps://www.luckymint.xyz
- —Total plays are 110 out of 10M token supplyhttps://www.luckymint.xyz
- —maxAmountRequired is 1000000 base units (1 USDC) on Base with USDC asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913https://www.luckymint.xyz/api/mint
- —Described as Farcaster mini app readyhttps://www.luckymint.xyz
- —Results described as provably fair randomhttps://www.luckymint.xyz