QuantumRand

True quantum randomness as a service. Every number generated by this API is decided by quantum physics — not mathematical formulas.

Live API: quantumrand.dev Docs: /docs

Quick Start

1. Get a free API key

Sign up at quantumrand.dev/signup to get your API key instantly.

2. Generate quantum random numbers

# Random bits
curl -H "X-API-Key: qr_your_key" \
  "https://quantumrand.dev/generate/bits?n=256"

# Random integer
curl -H "X-API-Key: qr_your_key" \
  "https://quantumrand.dev/generate/integer?min=1&max=1000"

# Cryptographic key
curl -X POST -H "X-API-Key: qr_your_key" \
  "https://quantumrand.dev/generate/key?bits=256"

SDKs

Python

pip install quantumrand

from quantumrand import QuantumRandClient

qr = QuantumRandClient("qr_your_key")
bits = qr.bits(256)       # "10110010..."
number = qr.integer(1, 100)  # 42
key = qr.key(256)          # "a3f9c2e1..."

JavaScript

npm install quantumrand

const { QuantumRandClient } = require('quantumrand')

const qr = new QuantumRandClient({ apiKey: 'qr_your_key' })
const bits = await qr.bits(256)
const number = await qr.integer(1, 100)
const key = await qr.key(256)

API Endpoints

Method	Path	Auth	Description
GET	/	No	Landing page
GET	/health	No	Health check
GET	/docs	No	Interactive API docs
GET	/api/info	No	API info
POST	/keys/create	No	Create API key
GET	/keys/me	Yes	Your key info
GET	/keys/stats	Yes	Usage statistics
GET	/generate/bits?n=256	Yes	Random bits (1-4096)
GET	/generate/hex?n=256	Yes	Random hex string
GET	/generate/integer?min=0&max=100	Yes	Random integer
POST	/generate/key?bits=256	Yes	Cryptographic key (128/192/256/512)
POST	/generate/batch	Yes	Multiple values in one call

Quantum Backends

Backend	Type	Speed
aer_simulator	Qiskit local simulator	Instant
origin_cloud	Origin Quantum cloud simulator	~1s
origin_wuyuan	Origin Quantum real hardware	~5s
ibm_hardware	IBM Quantum real hardware	2-30 min (queued)

Pass ?backend=aer_simulator for instant results or ?backend=ibm_hardware for bits from a real quantum computer.

Pricing

Tier	Price	Calls/Day	Max Bits
Free	$0	100	256
Indie	$9/mo	1,000	1,024
Startup	$49/mo	10,000	2,048
Business	$299/mo	100,000	4,096

How It Works

1. Superposition — Qubits enter superposition via Hadamard gates, existing as 0 and 1 simultaneously
2. Measurement — Quantum measurement collapses the state; physics alone decides the outcome
3. Your Response — Raw quantum bits are formatted into bits, hex, integers, or cryptographic keys

Tech Stack

• API: FastAPI + Uvicorn
• Quantum: Qiskit + AerSimulator, Origin Quantum, IBM Quantum
• Database: Firebase Firestore
• Auth: API key (X-API-Key header), tiered rate limits
• Hosting: Railway

Development

pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8000

python -m pytest tests/ -v -s

License

Copyright 2026 QuantumRand. All rights reserved.