Quantum Randomness API

The Free Universe Splitter provides a public API for accessing quantum randomness and monitoring the health of quantum sources. All endpoints return responses using true randomness from multiple international research institutions.

Public Endpoints

GET /

Returns a quantum-selected outcome from the classic Magic 8-Ball responses or custom options.

Parameters:

• outcome - Custom outcomes to choose from (can be specified multiple times)
• max - Generate numbered options from 1 to max

Example:

curl "https://api.freeuniversesplitter.com/?outcome=Pizza&outcome=Tacos"
curl "https://api.freeuniversesplitter.com/?max=10"

GET /rndnum

Returns a quantum random number generated from combined quantum sources.

Example:

curl https://api.freeuniversesplitter.com/rndnum

GET /status

Returns the latest status report from the most recent quantum source update, including timestamps and performance metrics.

Example:

curl https://api.freeuniversesplitter.com/status

Quantum Sources

The API combines randomness from seven diverse sources for maximum entropy and reliability:

• Australian National University - Quantum vacuum fluctuations measured through laser interferometry
• CURBy (NIST + University of Colorado) - Quantum entanglement measurements using Bell tests
• Brazilian INMETRO Beacon - Cryptographically signed quantum pulses from government laboratory
• German LfD Laboratory - ID Quantique hardware quantum generator using photon detection
• NIST Randomness Beacon - U.S. government quantum randomness beacon with 60-second pulses
• Random.org - Atmospheric noise converted to quantum randomness
• Cloudflare Web Crypto - Cryptographically secure pseudorandom generator

Cryptographic Combining

The API uses SHA-256 cryptographic hashing to securely combine randomness from all successful sources. This ensures:

• Uniform distribution - Hash functions create evenly distributed output
• Avalanche effect - Small changes in any source dramatically change the result
• Forward security - Previous outputs don't reveal information about future ones
• Domain separation - Sources are combined with delimiters to prevent collision attacks

Reliability

The system automatically handles source failures gracefully. If some quantum sources are unavailable, the API continues operating with the remaining sources. The system maintains a minimum entropy threshold and includes timestamps and source counts in the cryptographic combination for additional randomness.

Quantum sources are monitored hourly through automated cron jobs, with status information available through the /status endpoint. Response times and success rates are tracked for each source.

CORS Support

All endpoints include proper CORS headers (Access-Control-Allow-Origin: *) for browser-based applications and support both GET and OPTIONS requests.