Base URL: https://api.dcsai.ai/v1. Auth: Authorization: Bearer dcs_••••. Every response includes x-dcs-receipt-cid. The full OpenAPI 3.0 spec is at /openapi.json.
List, run, and stream the 641-agent catalog.
| Method | Path | Purpose |
|---|---|---|
| GET | /agents | List all 641 agents with metadata, capabilities, pricing tier |
| GET | /agents/:id | Agent details — input/output schema, modalities, sample I/O |
| POST | /agents/:id/run | Run agent with input; returns output + receipt_cid |
| POST | /agents/:id/stream | SSE streaming variant of /run |
| POST | /chat/completions | OpenAI-compatible chat endpoint (drop-in for OpenAI SDK) |
Submit jobs to the reverse-auction GPU lane.
| Method | Path | Purpose |
|---|---|---|
| POST | /compute/jobs | Submit a job (GPU type, hours, tolerance). Returns job_id + bid window |
| GET | /compute/jobs/:id | Job status, winning bid, worker SBT, ETA |
| GET | /compute/jobs/:id/output | Job output + signed completion receipt |
| DEL | /compute/jobs/:id | Cancel a job (only if status = queued) |
| GET | /compute/workers | List active workers + their trust scores + current load |
| GET | /compute/pricing | Real-time price quote for a given GPU + duration |
Content-addressed storage with Filecoin pinning.
| Method | Path | Purpose |
|---|---|---|
| POST | /storage/upload | Upload a file; returns CID + signed pin receipt |
| GET | /storage/:cid | Fetch by CID (gateway-routed, no auth needed for public CIDs) |
| GET | /storage/:cid/status | Replication status, tier, pin expiry, verifications |
| PUT | /storage/:cid/tier | Change replication tier (1×/3×/5×, 1-99 year retention) |
| DEL | /storage/:cid | Erasure request (subject to retention policy) — signed erasure receipt |
Per-tenant semantic memory with RTI-grade consent.
| Method | Path | Purpose |
|---|---|---|
| POST | /memory/store | Store a memory (text + metadata + consent token) |
| GET | /memory/search | Semantic search via pgvector cosine. ?q=...&top=10 |
| POST | /memory/recall | Recall by structured query (key, time range, source) |
| DEL | /memory/:id | Forget (right-to-erasure) — signed forget receipt |
| GET | /memory/audit/:tenant | Full read/write history for compliance — signed CSV export |
The cross-cutting substrate. No auth needed to verify.
| Method | Path | Purpose |
|---|---|---|
| GET | /receipts/:cid | Public receipt fetch — anyone can call, no auth |
| POST | /receipts/verify | Verify a receipt by CID + check chain integrity |
| GET | /receipts/chain/:start | Walk the receipt chain from start CID forward |
| GET | /receipts/keys | Public signing keys + their validity windows |
Cross-network peer protocol.
| Method | Path | Purpose |
|---|---|---|
| GET | /federation/peers | List active federated peers + their conformance levels |
| POST | /federation/handshake | HELLO message — peer announcement + capability exchange |
| POST | /federation/offer | OFFER work to a peer agent (cross-network) |
| POST | /federation/settle | Cross-peer settlement on Base mainnet (with 2.5% commission) |
Bearer API key, Supabase JWT (browser), MCP token (Claude Desktop / Cursor / Windsurf). All three forms valid on every endpoint.
Free: 60 req/min. Pro: 600 req/min. Enterprise: custom. Burst headroom managed automatically. Rate-limit headers returned on every response.
RFC 7807 Problem Details — every error includes type, title, status, detail, instance. x-dcs-error-cid ties the error to a signed event.
Full machine-readable spec at /openapi.json. Curl-friendly, SDK-friendly, MCP-friendly.