Entropy API

Production-grade randomness with provenance.

Hardware-derived entropy delivery with signed provenance, explicit fallback reporting, and post-quantum key encapsulation. Built for cryptographic key generation, secure messaging, and regulated systems.

What you get

Every draw includes provenance metadata, health checks, and transparent fallback behavior.

Hardware-derived entropy

Hardware-derived entropy with a disclosed source_class per draw. Each response carries a provenance record: source class, conditioning method, entropy score, and batch identifier.

Transparent fallback

If the reservoir is depleted or quality threshold is not met, the API switches to CSPRNG fallback. Always disclosed. Never silent.

Post-quantum encryption

Optional hybrid KEM key exchange (X25519 + ML-KEM-1024) with ML-DSA-65 signatures. Implements FIPS 203 (ML-KEM-1024) and FIPS 204 (ML-DSA-65) algorithms.

Audit trail

Append-only hash-linked audit log (R2 JSONL, retention by tier). Available for Verified and Enterprise tiers.

Web3 gateway private beta

Non-custodial entropy for wallets, dApps, and on-chain protocols. Quantum-safe seeds with signed provenance per draw.

Learn more →

API Endpoints

Public routes require no authentication. Authenticated routes require a valid API key.

Health

GET
/health

Service health and version metadata.

Access Request

POST
/v1/access/request

Request access or partner with us.

Entropy

POST
/v1/entropy

Primary entropy delivery endpoint with fallback reporting.

Encrypted Entropy (private beta)

POST
/v1/entropy/encrypted

Hybrid KEM-encrypted entropy with ML-DSA-65 signing.

Verify

POST
/v1/verify

Verify provenance of a past entropy draw by request ID or attestation.

Audit Lookup

GET
/v1/audit/:id

Retrieve a single audit record or filtered listings.

Account

GET
/v1/me · /v1/usage

Current identity and usage reporting for issued API keys.

Key Rotation

POST
/v1/keys/regenerate

Self-service API key rotation. New key returned immediately.

Ready to get started?

Request an API key or explore the developer guide to integrate entropy delivery into your application.