Quickstart

Make your first AKRUM API request in under five minutes. You'll generate cryptographic-grade randomness backed by AKRUM's Cellular Automata (Rule 30) entropy engine mixed with the OS CSPRNG through HKDF-SHA-256.

1. Sign up

Create a free account — no credit card required. The Free tier ships with 5,000 requests / month.

Create an account →

2. Generate an API key

Go to API keys and click New key. Keys begin with ak_live_.

3. Make your first request

Export your key as AKRUM_KEY and run one of the samples below. All four call the live GET /v1/random endpoint and produce 32 bytes of hex-encoded randomness on the first try.

curl https://akrum.io/api/public/v1/random \
  -H "Authorization: Bearer $AKRUM_KEY" \
  -G --data-urlencode "bytes=-n">32" \
     --data-urlencode "format=hex"

4. Verify the response

Every success response uses the same { data, meta } shape. meta.rate mirrors your live per-second and monthly quotas. Rate-limit headers accompany every response — see Rate limits.

{
  "data": {
    "bytes": 32,
    "format": "hex",
    "value": "9f1c4e...d8a2",
    "source": "akrum-ca-hkdf-v1"
  },
  "meta": {
    "algorithm_suite": "envelope-argon2id-aesgcm-v1",
    "suite_version": 1,
    "pqc_available": {
      "signatures": { "suite": "mldsa65-v1", "enable": "append ?sign=1 to any request" },
      "verify_key_url": "/api/public/v1/pqc/verify-key",
      "hybrid_kem": {
        "suite": "hybrid-mlkem768-x25519-aesgcm-v1",
        "encapsulate_url": "/api/public/v1/kem/encapsulate",
        "decapsulate_url": "/api/public/v1/kem/decapsulate",
        "required_scope": "kem",
        "standards": ["NIST FIPS 203", "RFC 7748", "RFC 5869", "NIST SP 800-38D"]
      }
    },
    "rate": { "rps_limit": 10, "monthly_used": 1, "monthly_limit": 5000 }
  }
}

Append ?sign=1 to any request to receive detachable ML-DSA-65 signature headers (x-akrum-signature, x-akrum-signature-suite, x-akrum-signature-message-sha256, x-akrum-signed-at).