API Reference
Last updated: March 12, 2026
Base URL
All API endpoints are available at https://dc1-platform.vercel.app/api/dc1 (proxied) or directly at http://76.13.179.86:8083/api.
Authentication
Most endpoints require an API key. Providers pass their key as a ?key= query parameter. Admin endpoints require an x-admin-token header.
Provider Endpoints
POST /api/providers/register
Register a new GPU provider. Body: name, email, gpu_model, os, phone (optional). Returns: provider_id, api_key, installer_url.
GET /api/providers/me?key=KEY
Fetch provider dashboard data including status, earnings, GPU metrics, and active job info.
POST /api/providers/heartbeat
Daemon heartbeat with GPU stats. Sent automatically by the DC1 daemon every 30 seconds.
POST /api/providers/pause
Pause the provider. Body: key. Provider will stop receiving new jobs.
POST /api/providers/resume
Resume a paused provider. Body: key.
GET /api/providers/download/daemon?key=KEY
Download the DC1 daemon Python script with the API key pre-injected.
GET /api/providers/download/setup?key=KEY&os=windows
Download platform-specific installer script (Linux shell or Windows PowerShell).
Renter Endpoints
POST /api/renters/register
Register a new renter. Body: name, email, organization (optional). Returns: renter_id, api_key.
GET /api/renters/me?key=KEY
Fetch renter dashboard data including balance, usage stats, and recent jobs.
GET /api/renters/available-providers
List all online GPU providers available for job submission.
POST /api/jobs/submit
Submit a compute job. Body: renter_key, provider_id, job_type (llm or image_gen), prompt, model.
GET /api/jobs/JOB_ID/output?key=KEY
Poll for job output. Returns status, result text/image, execution time, and billing breakdown.
Billing
LLM inference: 15 halala/minute. Image generation: 20 halala/minute. Revenue split: 75% provider, 25% DC1. All amounts in halala (1/100 SAR).
Rate Limits
API endpoints are currently not rate-limited during beta. This will change as the platform scales.