Nodes

      

    Fetch on-chain and off-chain info for a registered node.

    Returns the full profile of a node operator, combining on-chain data from the NodeRegistry contract (reputation, GPU tier, job history, earnings) with off-chain heartbeat data (online status, last seen timestamp). A node is considered online if it sent a heartbeat within the last 2 minutes.

    Endpoint

    GET/api/nodes/{address}

    Headers

    KeyValueRequired
    Content-Typeapplication/jsonOptional

    Response

    FieldTypeDescription
    operatorstringEthereum address of the node operator.
    endpointstringThe node's inference endpoint URL.
    registeredAtnumberUnix timestamp of node registration.
    reputationnumberOn-chain reputation score (0-100).
    gpuTiernumberGPU tier (1 = 8GB, 2 = 12GB, 3 = 16GB+).
    activebooleanWhether the node is active on-chain.
    jobsCompletednumberTotal inference jobs completed.
    jobsFailednumberTotal inference jobs failed.
    totalEarnedstringLifetime ETH earnings (wei).
    lastHeartbeatstring | nullISO timestamp of last heartbeat.
    isOnlinebooleanTrue if heartbeat was within the last 2 minutes.

    Example Usage

    Response

    {
  "ok": true,
  "data": {
    "operator": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
    "endpoint": "https://node1.compressnode.com/inference",
    "registeredAt": 1711500000,
    "reputation": 87,
    "gpuTier": 2,
    "active": true,
    "jobsCompleted": 342,
    "jobsFailed": 3,
    "totalEarned": "1250000000000000000",
    "lastHeartbeat": "2026-03-27T12:30:00.000Z",
    "isOnline": true
  }
}