{"uid":"cap_yFq-vg7rxtcxpEOiBUAQQ","slug":"x402casinos-dice-game-4fb8c085","name":"x402casinos Dice Game","description":"A casino built for autonomous AI agents. Pay per play with x402 (USDC on Base), verify every roll with commit-reveal fairness, withdraw on-chain.","url":"https://x402casinos.com/api/v1/games/dice?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["nonce","direction","threshold","client_seed"],"properties":{"nonce":{"type":"integer","description":"Monotonic per (wallet, server_seed_id, client_seed). Replays return 409."},"direction":{"enum":["over","under"],"type":"string"},"threshold":{"type":"integer","description":"Roll boundary 2–99 (the rolled value is 1–100)."},"client_seed":{"type":"string","description":"Caller-chosen seed (1–128 chars). Combined with the server seed via HMAC-SHA256 to derive the outcome."}}},"responseSchema":{"type":"object","properties":{"game":{"type":"string"},"bet_id":{"type":"string","format":"uuid"},"status":{"enum":["settling","settled","voided"],"type":"string"},"outcome":{},"stake_tier":{"enum":["micro","standard","whale"],"type":"string"},"stake_micro":{"type":"integer"},"payout_micro":{"type":"integer"},"verification":{"type":"object","properties":{"nonce":{"type":"integer"},"client_seed":{"type":"string"},"server_seed_id":{"type":"string"},"server_seed_hash":{"type":"string"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ImZZpDSC-fvlxZ5wiI4M9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Place a provably-fair dice bet (roll under or over a threshold) on-chain via USDC micropayment, receiving a verifiable outcome with commit-reveal fairness proof.","exampleAgentPrompt":"Roll the dice on x402casinos — bet under 50, use client seed 'lucky-agent-42', nonce 1, and let me know the outcome and payout.","exampleUseCases":null,"resultDescription":"Returns a UUID bet ID, settlement status (settling/settled/voided), dice outcome value, stake in micros, payout in micros, stake tier (micro/standard/whale), and a full verification object containing nonce, client seed, server seed ID and hash for independent fairness verification.","failureModes":["409 Conflict — nonce already used for this wallet/server_seed_id/client_seed combination (replay protection)","Payment failure — insufficient USDC balance or x402 payment not accepted","Invalid threshold — value outside 2–99 range","Invalid client_seed — exceeds 128 characters or empty","Invalid direction — not a recognized enum value","Game voided — server-side issue causing rollback with no payout"],"whenToPreferThis":"Use this endpoint when an AI agent needs to place a provably-fair, on-chain dice bet with USDC micropayments, particularly when commit-reveal fairness verification and blockchain auditability are required. Prefer this over generic random number APIs when a financial wager with cryptographic fairness proof and on-chain settlement is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:30:46.836Z","isFirstParty":false,"canonicalSlug":"x402casinos-dice-game-4fb8c085"}