API Reference
Base URL: https://driftrail.com/nerox/api
Authentication
All requests require a Bearer token in the Authorization header:
Authorization: Bearer nrx_sk_...
/v1/jobsSubmit an optimization job. Returns a job_id immediately. Supports TSP, CVRP, portfolio, scheduling, MaxCut, bin packing, and raw QUBO.
Request body
{ problem_type, payload, solver, config }Returns
{ job_id, status, queued_at }/v1/jobs/{job_id}Fetch job status and result. Poll until status is "completed" or "failed".
Request body
—Returns
{ job_id, status, result, runtime_s, gpu_seconds }/v1/jobs/{job_id}/streamOpen a WebSocket connection to stream real-time solver progress events.
Request body
—Returns
WebSocket stream of { iteration, energy, best_energy, timestamp }/v1/jobsList jobs with pagination. Filter by status, solver, or problem type.
Request body
—Returns
Paginated list of job summaries/v1/jobs/{job_id}Cancel a running job. Billed GPU-seconds up to cancellation time.
Request body
—Returns
{ cancelled: true }/v1/datasetsUpload a problem instance to the Dataset Hub for reuse or benchmarking.
Request body
Multipart: file + metadataReturns
{ dataset_id, name, size }/v1/datasetsList available datasets including community benchmarks and your uploads.
Request body
—Returns
Paginated list of dataset metadata/v1/usageFetch GPU-second usage for the current billing period with per-solver breakdown.
Request body
—Returns
{ included, used, overage, by_solver }Rate limits
Starter
20 jobs/mo, 10 req/min
Pro
2,000 jobs/mo, 60 req/min
Business
Unlimited, 300 req/min
GPU-native quantum-inspired optimization for combinatorial problems at any scale.