Introduction

The Quantinal API is a RESTful JSON API that gives you programmatic access to your spaces, trackers, runs, and vault data. Everything you can do in the console — create trackers, trigger runs, upload data sources — you can automate through the API.

Base URL

All endpoints are served under a single versioned base:

https://api.quantinal.ai/v1

Authentication

Include your API token in the Authorization header. Tokens start with qapi_.

Authorization: Bearer qapi_your_token

You can also pass your token via X-API-Key or X-API-Token headers.

Get your token: Console → Account → API Tokens

API Token Scope

API tokens provide programmatic access to your resources:

• Spaces — Read only (list, get). Create trackers in spaces.
• Trackers — Full access (CRUD, trigger runs, list runs, get/delete runs)
• Tracker Vault — Read access and source management (upload, list, update, delete sources)

Web Console Only

The following operations require the web console (not accessible via API tokens):

• Space creation, update, and deletion
• Skill discovery and listing
• Billing, payment management, and webhooks
• Account settings and API token management
• Marketplace and privacy operations

---

Response Format

All endpoints return JSON. Successful responses include the resource data directly or wrapped in a data array for list endpoints.

Single resource:

{
  "space_id": "spc_abc123",
  "name": "Market Research",
  ...
}

List endpoints:

{
  "data": [ ...items... ],
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total_items": 53,
    "total_pages": 3
  }
}

---

Errors

Error Format

{"detail": "Tracker not found"}

Code	Meaning
400	Invalid request — check parameters and request body
401	Unauthorized — invalid or missing API token
402	Insufficient quants — top up your balance
403	Forbidden — endpoint requires web console, or access denied
404	Not found — resource doesn't exist or you don't own it
422	Validation error — invalid field values
429	Rate limited — slow down and retry

---

Pagination

List endpoints return paginated results:

Parameter	Type	Description
page	integer	Page number (default: 1)
page_size	integer	Items per page (default: 20, max: 100)