Reference / REST API

REST API

All endpoints return JSON. No authentication required for read endpoints in this build — partner key auth is added when Lovable Cloud is enabled.

GET/api/health

Health probe. Returns service status, version, and current server time.

{
  "status": "ok",
  "version": "0.1.0",
  "time": "2026-05-15T17:28:00.000Z"
}

GET/api/deals

List active deals. Optional ?category=… and ?limit=… (max 100).

{
  "deals": [
    {
      "id": "neural-core-v4",
      "title": "NEURAL_CORE V4",
      "seller": "NEXUS_CORP",
      "category": "Compute Units",
      "price": 890,
      "marketPrice": 1047,
      "discountPct": 15,
      "rating": 99.8,
      "endsAt": "2026-05-15T21:28:00.000Z",
      "status": "live"
    }
  ]
}

GET/api/deals/:id

Fetch a single deal by ID. Returns 404 with { deal: null } when not found.

{
  "deal": {
    "id": "neural-core-v4",
    "title": "NEURAL_CORE V4",
    "description": "8th-gen tensor inference module...",
    "...": "..."
  }
}

Errors

Standard HTTP status codes. Errors return { error: string }.