Quantum Random API – Documentation

The Quantum Random API provides unpredictable random values based on quantum-level noise. It is designed for games, simulations, lotteries, password generation and other use-cases where high-quality randomness matters.

---

🔧 API Endpoint

POST https://quantum.api.ventureout.cz/random
Content-Type: application/json

---

📦 Request Format

Send an array of random tasks inside a single request:

{
  "request": [
    {
      "random": {
        "type": "int | string",
        "range": [min, max],     // for type=int
        "alphabet": "ABC…",      // for type=string
        "count": number_of_items_or_chars,
        "unique": true|false
      }
    }
  ]
}

---

🎲 Random Integers

Example: generate 5 unique numbers between 1–50 (e.g. for Sportka/EUROJACKPOT):

{
  "request": [
    {
      "random": {
        "type": "int",
        "range": [1, 50],
        "count": 5,
        "unique": true
      }
    }
  ]
}

---

🎰 Lottery Examples

• Sportka (6 numbers 1–49)

{
  "request": [
    { "random": { "type": "int", "range": [1,49], "count": 6, "unique": true }}
  ]
}

• Eurojackpot (5 numbers 1–50 + 2 numbers 1–12)

{
  "request": [
    { "random": { "type": "int", "range": [1,50], "count": 5, "unique": true }},
    { "random": { "type": "int", "range": [1,12], "count": 2, "unique": true }}
  ]
}

---

🧊 Dice Rolls (DnD / RPG)

{
  "request": [
    { "random": { "type": "int", "range": [1,6], "count": 4, "unique": false }}
  ]
}

---

🔤 Random String / Text Generation

Basic alphanumeric string (16 chars):

{
  "request": [
    {
      "random": {
        "type": "string",
        "alphabet": "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
        "count": 16,
        "unique": false
      }
    }
  ]
}

Secure password (20 chars):

{
  "request": [
    {
      "random": {
        "type": "string",
        "alphabet": "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()-_=+<>?",
        "count": 20,
        "unique": false
      }
    }
  ]
}

HEX token (64 chars):

{
  "request": [
    {
      "random": {
        "type": "string",
        "alphabet": "0123456789abcdef",
        "count": 64,
        "unique": false
      }
    }
  ]
}

Custom alphabet:

{
  "request": [
    {
      "random": {
        "type": "string",
        "alphabet": "ABCDEF123",
        "count": 10,
        "unique": false
      }
    }
  ]
}

---

🛡 Rate Limiting

The public API is limited to:

• 3 requests per minute per IP
• No API key needed for basic exploration

Higher limits & API keys will be added later.

---

📘 Notes

• type: "int" → requires range
• type: "string" → requires alphabet
• unique: true ensures non-repeating values (only for integers)
• Multiple random tasks can be executed in a single HTTP request

The Quantum API is simple and predictable — each request is transparent and logged, and all numbers are generated using quantum-level entropy (simulated for speed).

Author: Antonin Ecer — VentureOut Labs