How It Works
Our provably fair system ensures complete transparency in random number generation.
1. Server Seed
A secure, hashed server seed is generated for your user
2. Client Input
Your user provides their own client seed for added randomness
3. Verification
Results can be independently verified for fairness
Features
- Multiple random generation methods
- Complete transparency with seed verification
- High-performance cryptographic functions
- Easy integration via REST API
- Abstracting the RNG guarantees safety for operators
API Access & Pricing
Currently, API accounts and access are provided through RapidAPI:
RapidAPI - Provably Fair Random Number GeneratorComing Soon: Direct API access will be available soon, providing more flexible pricing options and enhanced features.
When using the API through RapidAPI, you'll need to include your RapidAPI authentication headers with each request:
X-RapidAPI-Key: your_rapidapi_key X-RapidAPI-User: your_username
API Usage Guide
Getting Started
- Create an account - Call the
/new
endpoint to receive a unique seed ID for your user. - View your seed - Use your users seed ID to view their current server seed hash and nonce.
- Generate random results - Use your users seed ID and a client seed to get provably fair random outcomes.
- Verify results - Anyone can verify the fairness of results using the original inputs.
Core API Endpoints
Create a New User Account
GET /new
Creates a new user account and returns a seed ID you'll use for all future requests for that user.
curl https://api.example.com/new
View Current Seed
GET /view
View the users current server seed information (hash and nonce).
curl "https://api.example.com/view?id=your_seed_id"
Generate Random Results
GET /result
Generate provably fair random outcomes using various methods.
curl "https://api.example.com/result?id=your_seed_id&clientSeed=your_seed&generatedResults=PERCENTILE_RESULT"
Verify Results
GET /verify
Verify that a previously generated result was fair.
curl "https://api.example.com/verify?nonce=1&serverSeed=revealed_seed&clientSeed=your_seed&generatedResults=PERCENTILE_RESULT"
Available Random Generation Methods
Method | Description | Parameters |
---|---|---|
PERCENTILE_RESULT | Random value from 0-100 | None |
PERCENTILE_RESULT_REPEAT | Multiple random values from 0-100 | selections (number of results) |
DICE_RESULT | Random dice roll (1-6) | None |
DICE_RESULT_REPEAT | Multiple random dice rolls (1-6) | selections (number of rolls) |
ANY_RESULT | Random value from 0 to max | outOfX (maximum value) |
CARD_DECK | Shuffled deck(s) of cards | deckCounter (number of decks) |
RANDOM_SHUFFLE | Randomly shuffle a list | itemOptions (array of items) |
RANDOM_SELECTOR | Random item from a list | itemOptions (array of items) |
RANDOM_GROUP_SELECTOR | Select multiple random items from a list | itemOptions, selections (number to select) |
RANDOM_GROUP_SELECTOR_REMOVAL | Select multiple random items without replacement | itemOptions, selections (number to select) |
PVE_OSRS_STAKE | Old School RuneScape Abyssal Whip stake simulation | None |
PVE_RS3_STAKE | RuneScape 3 Polypore staff stake simulation | None |
Code Example
// JavaScript example async function generateRandomResult() { const response = await fetch( 'https://api.example.com/result?id=your_seed_id&clientSeed=my_client_seed&generatedResults=PERCENTILE_RESULT', { headers: { 'X-RapidAPI-User': 'your_username' } } ); const data = await response.json(); console.log('Random result:', data.result); }
Try it out!
Click here to use our verification tool