Explorer

      

    Live event feed showing recent network activity (jobs, node registrations).

    Returns a paginated feed of network events sorted by most recent first. Events include job completions, job submissions, and node registrations. Each event has a type, timestamp, and type-specific data payload. Responses are cached for 10 seconds. Falls back to realistic demo data if the Supabase events table is not yet configured.

    Endpoint

    GET/api/explorer/feed

    Headers

    KeyValueRequired
    Content-Typeapplication/jsonOptional

    Request Body

    FieldTypeRequiredDescription
    limitnumber (query)OptionalNumber of events to return (default: 20, max: 100).
    offsetnumber (query)OptionalOffset for pagination (default: 0).

    Response

    FieldTypeDescription
    eventsarrayArray of feed event objects.
    events[].idstringUnique event ID.
    events[].typestringEvent type: job_completed, job_submitted, or node_registered.
    events[].timestampstringISO 8601 timestamp.
    events[].dataobjectType-specific event payload.
    totalnumberTotal number of events returned.

    Example Usage

    Response

    {
  "ok": true,
  "data": {
    "events": [
      {
        "id": "evt_a1b2c3",
        "type": "job_completed",
        "timestamp": "2026-03-27T12:15:00.000Z",
        "data": {
          "jobId": 1042,
          "model": "llama-3.1-8b-compressed",
          "payment": "0.35",
          "duration": "1.2s"
        }
      },
      {
        "id": "evt_d4e5f6",
        "type": "node_registered",
        "timestamp": "2026-03-27T11:45:00.000Z",
        "data": {
          "address": "0x742d35Cc...",
          "tier": 2,
          "stake": "2500"
        }
      }
    ],
    "total": 2
  }
}