{"uid":"cap_KR4vylV2WIpSSxmWefPRL","slug":"3hz-verified-random-integer-87c17957","name":"3HZ Verified Random Integer","description":"Cryptographically verifiable random integer generated from the public drand Quicknet randomness beacon. Choose inclusive min and max values. The response includes the drand round, randomness and signature so the result can be independently checked.","url":"https://wallet-services-poc-clean-mainnet.3hz-services.workers.dev/verified-random","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"max":{"type":"integer","default":100,"description":"Inclusive maximum integer"},"min":{"type":"integer","default":1,"description":"Inclusive minimum integer"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["value","min","max","round","randomness","signature","source","chain_hash","algorithm","fetched_at"],"properties":{"max":{"type":"integer"},"min":{"type":"integer"},"round":{"type":"integer"},"value":{"type":"integer"},"source":{"type":"string"},"algorithm":{"type":"string"},"signature":{"type":"string"},"chain_hash":{"type":"string"},"fetched_at":{"type":"string"},"randomness":{"type":"string"}}}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GWtIPgCVIVyGpEeC3LasR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a cryptographically verifiable random integer within a user-specified inclusive range, backed by the public drand Quicknet randomness beacon with full proof data.","exampleAgentPrompt":"Give me a verifiable random integer between 1 and 500, including the drand beacon signature and round number so I can confirm the result is legit.","exampleUseCases":[{"title":"Provably fair raffle winner selection","prompt":"Pick a random number between 1 and 250 for our raffle draw, and give me the drand beacon proof so participants can verify it wasn't rigged."},{"title":"Auditable dice roll for board game","prompt":"Roll a fair six-sided die for me — give me a random number between 1 and 6 with the cryptographic signature so I can prove it was random."},{"title":"Random seed generation for simulation","prompt":"Generate a verifiable random integer between 1 and 1000000 to use as a seed for my simulation, and include the randomness and chain hash so I can document the source."}],"resultDescription":"A JSON object containing: the generated integer value within the requested range, the inclusive min and max used, the drand round number, the raw randomness hex string, the beacon signature, the chain hash, the algorithm name, the source URL, and a fetched_at timestamp — enabling full independent verification of the random output.","failureModes":["Invalid min/max values (e.g. min greater than max) result in a 400-level error","drand beacon temporarily unavailable causes a service error","Payment not included or invalid results in a 402 Payment Required response","Non-integer query parameter values cause a validation error"],"whenToPreferThis":"Choose this endpoint when you need a random integer that is publicly auditable and cryptographically verifiable — for use cases like lotteries, raffles, games, or any scenario where participants must be able to independently confirm the randomness was not manipulated. Prefer this over a standard PRNG or non-verifiable random API when fairness guarantees and auditability matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:30:14.058Z","isFirstParty":false}