Algorithms Module

The algorithms module provides ready-to-run implementations of canonical quantum algorithms. No circuit construction required — pass parameters, get results.

List available algorithms

curl https://api.softquantus.com/api/v1/algorithms/ \
  -H "Authorization: Bearer sq-live-your-key"

Grover’s Search

Finds a target item in an unstructured space of 2^n items in O(√N) operations — quadratic speedup over classical. Use cases: Database search, constraint satisfaction, combinatorial optimisation.

curl -X POST https://api.softquantus.com/api/v1/algorithms/grover/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "n_qubits": 4,
    "target": 10,
    "shots": 1024
  }'

result = client.algorithms.grover(target="1010", shots=1024)
print(result)

Runs execute on the managed local simulator; pass "async_run": true to get a job_id and poll GET /api/v1/algorithms/jobs/{job_id}.

Shor’s Factoring Algorithm

Factors an integer N into prime factors in polynomial time — exponential speedup over classical. Foundational for post-quantum cryptography research. Use cases: Cryptography research, RSA vulnerability assessment, prime factorisation.

curl -X POST https://api.softquantus.com/api/v1/algorithms/shor/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{"N": 15, "shots": 1024}'

Response:

{
  "N": 15,
  "factors": [3, 5],
  "verification": "3 × 5 = 15 ✓",
  "algorithm": "shor"
}

QAOA — Quantum Approximate Optimisation Algorithm

Solves combinatorial optimisation problems. Currently supports MaxCut on graphs. Use cases: Portfolio optimisation, logistics routing, network partitioning, scheduling.

curl -X POST https://api.softquantus.com/api/v1/algorithms/qaoa/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "edges": [[0,1],[1,2],[2,3],[3,0],[0,2]],
    "n_vertices": 4,
    "p_layers": 2,
    "shots": 2048
  }'

QFT — Quantum Fourier Transform

Applies the Quantum Fourier Transform (or inverse) to a computational basis state. Use cases: Phase estimation subroutine, signal processing, period finding.

curl -X POST https://api.softquantus.com/api/v1/algorithms/qft/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{"n_qubits": 4, "input_state": 5, "inverse": false, "shots": 1024}'

QPE — Quantum Phase Estimation

Estimates the phase φ of a unitary’s eigenvalue e^(2πiφ) to n precision bits. Use cases: Chemistry (energy estimation), Shor’s algorithm subroutine, HHL linear systems.

curl -X POST https://api.softquantus.com/api/v1/algorithms/qpe/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "n_precision": 4,
    "phase": 0.125,
    "shots": 1024
  }'

Deutsch-Jozsa

Determines if a function is constant or balanced in a single query — exponential speedup. Use cases: Teaching quantum advantage, oracle testing, algorithm benchmarking.

curl -X POST https://api.softquantus.com/api/v1/algorithms/deutsch_jozsa/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{"oracle_type": "balanced", "n_qubits": 3, "shots": 1024}'

Bernstein-Vazirani

Recovers a hidden binary string in a single quantum query.

curl -X POST https://api.softquantus.com/api/v1/algorithms/bernstein_vazirani/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{"secret": "10110", "shots": 1024}'

Hybrid HPC + QPU

Runs workloads where classical steps execute on CPU/LUMI HPC and quantum steps on QPU. Use cases: VQE molecular simulation, QAOA with classical optimiser, ML-quantum pipelines.

curl -X POST https://api.softquantus.com/api/v1/algorithms/hybrid/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "preset": "vqe_molecular",
    "initial_context": {
      "molecule_geometry": {"atoms": [["H",0,0,0],["H",0,0,0.74]], "basis": "sto-3g"},
      "max_iterations": 50,
      "shots": 1024
    }
  }'

Presets: vqe_molecular and portfolio (portfolio requires initial_context.returns and initial_context.covariance).

Run any algorithm by name

POST /api/v1/algorithms/{name}/run executes any registered algorithm; pass algorithm-specific parameters inside params:

curl -X POST https://api.softquantus.com/api/v1/algorithms/grover/run \
  -H "Authorization: Bearer sq-live-your-key" \
  -H "Content-Type: application/json" \
  -d '{"params": {"n_qubits": 4, "target": 10}, "shots": 1024}'

Track async algorithm jobs

# List running algorithm jobs
curl https://api.softquantus.com/api/v1/algorithms/jobs/ \
  -H "Authorization: Bearer sq-live-your-key"

# Get specific job result
curl https://api.softquantus.com/api/v1/algorithms/jobs/job_abc123 \
  -H "Authorization: Bearer sq-live-your-key"

Core

Modules

Certification

Algorithms

Algorithms Module

List available algorithms

Grover’s Search

Shor’s Factoring Algorithm

QAOA — Quantum Approximate Optimisation Algorithm

QFT — Quantum Fourier Transform

QPE — Quantum Phase Estimation

Deutsch-Jozsa

Bernstein-Vazirani

Hybrid HPC + QPU

Run any algorithm by name

Track async algorithm jobs

​Algorithms Module

​List available algorithms

​Grover’s Search

​Shor’s Factoring Algorithm

​QAOA — Quantum Approximate Optimisation Algorithm

​QFT — Quantum Fourier Transform

​QPE — Quantum Phase Estimation

​Deutsch-Jozsa

​Bernstein-Vazirani

​Hybrid HPC + QPU

​Run any algorithm by name

​Track async algorithm jobs

Algorithms Module

List available algorithms

Grover’s Search

Shor’s Factoring Algorithm

QAOA — Quantum Approximate Optimisation Algorithm

QFT — Quantum Fourier Transform

QPE — Quantum Phase Estimation

Deutsch-Jozsa

Bernstein-Vazirani

Hybrid HPC + QPU

Run any algorithm by name

Track async algorithm jobs