✳ RandomKit

RandomKit REST API

RandomKit REST API · RandomKit

POST /api/v1/generate

Send a JSON body with Content-Type: application/json. This example generates integers.

ParameterDescription
toolGenerator name. Use integers for whole numbers.
input.min / input.maxInclusive bounds from −10¹² to 10¹². Defaults: 1 and 100.
input.count1–10,000. Default: 1.
input.uniqueSet true to sample without replacement. Default: false.
input.sortSet true for ascending order. Default: generation order.
localeOptional. With a locale, the response includes formatted. en, ru, zh-TW, zh-CN, hi, ja, ko, es

curl

curl -X POST "https://randomkit.tech/api/v1/generate" -H "Content-Type: application/json" -d '{"tool":"integers","locale":"en","input":{"min":1,"max":100,"count":5,"unique":true,"sort":true}}'

fetch

const response = await fetch('/api/v1/generate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"tool":"integers","locale":"en","input":{"min":1,"max":100,"count":5,"unique":true,"sort":true}})
})
const data = await response.json()
if (!response.ok) throw new Error(data.error)
console.log(data.values, data.formatted)
console.log(response.headers.get('RateLimit-Remaining'))

Response and quota

Successful responses contain tool and values. With locale, they also include locale, label and formatted. Formatted integers have number and text fields.

400: invalid request. 429: quota exhausted, with Retry-After in seconds. 503: quota service unavailable. Requests rejected with 400 also count toward the quota.

Verifiable draws and Seed

Use the browser tools for Seed and drand. On the draw page you can select a winner and download a JSON proof. Open verifiable draw

API Playground

Tools

CORE
Web CryptoSeeddrand
Random Number GeneratorGenerate integers in an inclusive range.Open tool
CORE
Web CryptoSeed
Random Sequence GeneratorSample distinct integers in random order.Open tool
SOCIAL
Web CryptoSeed
Random List PickerPick one or more entries from your list.Open tool
GAMES
Web CryptoSeed
Online Dice RollerRoll dice using notation like 2d6+3.Open tool
GAMES
Web CryptoSeed
Coin FlipFlip a fair virtual coin.Open tool
GAMES
Web CryptoSeed
Playing Card ShufflerDraw from a shuffled 52-card deck.Open tool
GAMES
Web CryptoSeed
Lottery Quick PickChoose unique lottery numbers from a custom pool.Open tool
SECURITY
Web Crypto
Random Password GeneratorCreate passwords with a custom alphabet.Open tool
SECURITY
Web CryptoSeed
Random String GeneratorGenerate strings from a custom alphabet.Open tool
CORE
Web CryptoSeed
Normal Distribution GeneratorSample values with a chosen mean and standard deviation.Open tool
DATA
Web CryptoSeed
Random HEX ColorsGenerate random RGB colors and preview them.Open tool
DATA
Web CryptoSeed
Random CoordinatesSample locations uniformly over the globe.Open tool
SECURITY
Web CryptoSeed
Random BytesGenerate a sequence of bytes in hex or Base64.Open tool
DATA
Web CryptoSeed
Random Date and TimeSample timestamps between two UTC dates.Open tool
CORE
Web CryptoSeed
Advanced Integer GeneratorSample integers with output in bases 2–36.Open tool
WIDGETS
Web CryptoSeed
Integer Widget BuilderConfigure an integer generator and copy its iframe code.Open tool
WIDGETS
drand
Draw Widget BuilderVerify a drand draw and embed the draw form.Open tool
SOCIAL
drand
Charity Draw GeneratorSelect a winner using a published drand round.Open tool
SOCIAL
Web CryptoSeed
Wheel of NamesSpin a wheel to choose an entry from your list.Open tool
SOCIAL
Web CryptoSeed
Random Name PickerPick a name from a list of participants.Open tool
SOCIAL
Web CryptoSeed
Random Group GeneratorSplit participants into balanced-size groups.Open tool
CORE
Web CryptoSeed
Random Number PickerPick a number using the 1–10 and 1–100 presets.Open tool
DATA
Web CryptoSeed
Random Letter GeneratorSample letters or characters from a chosen alphabet.Open tool
DATA
Web CryptoSeed
Random Word GeneratorPick words from a built-in or custom list.Open tool
DATA
Web CryptoSeed
Random Birthday GeneratorSample calendar dates from a chosen interval.Open tool
DATA
Web Crypto
Random Image PickerPick an image from files on your device.Open tool
SOCIAL
Web CryptoSeed
Comment Giveaway PickerPick a winner from pasted or imported comments.Open tool
CORE
Seed
Seeded Research SamplerSample distinct observations using a documented seed.Open tool
SOCIAL
Web CryptoSeed
Audience SpinnerSpin a wheel from an audience list.Open tool
DATA
Web CryptoSeed
Test Data GeneratorGenerate synthetic profiles for software testing.Open tool
SECURITY
Web CryptoSeed
IP, MAC and UUID GeneratorGenerate test identifiers in a selected format.Open tool
DATA
Web CryptoSeed
Random Emoji GeneratorPick emoji and symbols from a built-in set.Open tool
SOCIAL
Web CryptoSeed
Random Team MakerDistribute players across teams by role.Open tool
CORE
Web CryptoSeed
Random Decimal GeneratorGenerate decimal fractions with up to 10 digits.Open tool
SOCIAL
Web CryptoSeed
Random Decision MakerChoose yes, no, or an option from your list.Open tool
SOCIAL
drand
Verifiable Random DrawDerive a winner from a signed drand round.Open tool