Provably fair RNG API

Cryptographically verifiable random numbers.

A free, open-source API for provably fair random floats and integers. Every outcome includes a server hash you can independently verify.

API Documentation View on GitHub Verify an Outcome Recently shared outcomes

Public API

Access our RESTful API to generate provably fair random numbers for your applications.

GET /api/floats?clientSeed=your-seed&count=5 Explore the API

Open Source

Our core library is open source. Review our algorithms, contribute, or build your own implementation.

npm install @provableio/provable-core View Repository

Core Features

Everything you need to generate and verify random numbers with confidence.

Random Floats

Generate cryptographically secure random floating point numbers between 0 and 1.

Random Integers

Generate random integers within custom ranges for games, lotteries, and more.

Provably Fair

Every outcome includes a server hash for independent verification of fairness.

Outcome History

Access and audit past outcomes with complete transparency and traceability.

Try It Live

Generate random numbers right now with our API.

cURL
Live Response 
{
  "outcome": [],
  "message": "Click 'Generate' to try the API"
}
Your random numbers will appear here

Built For

Sharply-targeted landing pages for the most common verifiable-RNG workloads.

Dice Roller API

Standard NdM notation, verifiable per-roll outcomes.

Raffle Picker API

Draw a winner from a list, publish proof anyone can verify.

Card Shuffler API

A verifiable Fisher-Yates shuffle in one HTTP call.

A/B Test Bucketing API

Deterministic, auditable variant assignment.

Compare To

How Provable.io stacks up against the usual suspects.

vs Random.org

Hardware entropy vs publicly verifiable randomness.

vs Chainlink VRF

The off-chain alternative — no gas, no LINK, same proof.

vs crypto.randomUUID()

When the local CSPRNG isn't enough.

Frequently Asked Questions

Got questions? We've got answers.

What is a provably fair random number?

A provably fair random number is an outcome that anyone can independently verify was not chosen on purpose. The server publishes a cryptographic hash of its secret seed before you ask for a number; once your client seed is mixed in and the server seed is revealed, anyone can recompute the result and prove it matches the original hash.

Is the API free to use?

Yes. Anonymous calls are free and rate-limited by IP. Signing up gives you an API key for usage attribution and a daily quota of 10,000 requests at no cost.

How do I verify a past outcome?

Go to the /verify page or call GET /api/verifyServerHash with the original clientSeed and serverHash. The endpoint returns true if the values match our records, confirming the outcome was generated as claimed.

Can I use this for online gaming or a casino?

Provable.io is a general-purpose verifiable RNG suitable for game mechanics, raffles, NFT trait reveals, and similar use cases. It is not itself a gaming licence — operators in regulated jurisdictions are responsible for their own compliance, but the cryptographic transparency the API provides is exactly the kind of evidence regulators and players ask for.

How does the commit-reveal flow work?

Call POST /api/commit to receive a commitment id and a hash of an outcome that has been generated but not yet shown to you. Later, call POST /api/reveal with the commitment id to receive the outcome itself. Because the hash was issued before reveal, neither party could have changed the result after the fact.

What rate limits apply?

Anonymous and test-mode requests are capped at 120 requests per minute per IP. Authenticated live calls additionally count against a daily quota of 10,000 per account (configurable via the DAILY_QUOTA environment variable for self-hosted deployments).

Is the code open source?

Yes. Our core random generation library is fully open source on GitHub at github.com/provableio/provable-core. You can review the code, audit the algorithms, or run your own implementation.