Developer API

Pull truly random numbers — sourced from live quantum noise, real earthquakes, or hardware jitter — straight into your app, with a full technical proof attached to every response.

Quickstart

Every request needs an API key sent in the X-API-Key header. See "Getting a key" below if you don't have one yet.

curl -X POST https://randomnumber.biz/api/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -d '{"source": "quantum", "min": 1, "max": 100, "count": 5}'

const res = await fetch("https://randomnumber.biz/api/v1/generate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_KEY_HERE"
  },
  body: JSON.stringify({ source: "quantum", min: 1, max: 100, count: 5 })
});
const data = await res.json();
console.log(data.values);

import requests

res = requests.post(
    "https://randomnumber.biz/api/v1/generate",
    headers={"X-API-Key": "YOUR_KEY_HERE"},
    json={"source": "quantum", "min": 1, "max": 100, "count": 5},
)
print(res.json()["values"])

Endpoints

Method	Path	Description
POST	`/api/v1/generate`	Generate 1-100 random values from a chosen entropy source
GET	`/api/v1/sources`	List available entropy sources and their descriptions
GET	`/api/v1/usage`	Check your key's current rate limit and daily usage

Full interactive reference (request/response schemas, try-it-out): randomnumber.biz/api/docs

Sources

id	Source	Needs client_entropy?
`quantum`	Live quantum vacuum fluctuations (ANU QRNG)	No
`server`	Server CPU hardware timing jitter	No
`earthquake`	Live global earthquake data (USGS)	No
`mouse`	Mouse-movement entropy	Yes (browser-only)
`motion`	Phone accelerometer/gyroscope	Yes (browser-only)

For server-to-server API use, quantum, server, and earthquake are the practical choices since mouse and motion need real browser sensor data.

Rate limits

Tier	Per minute	Per day
Free	10	500

Exceeding a limit returns HTTP 429 with a message explaining which limit was hit. Check /api/v1/usage any time to see where you stand.

Getting a key

Keys are currently issued manually while this API is in early access.

Request an API key →