API Reference

Core API endpoints for immune node management, threat detection, consensus queries, governance participation, and network metrics. All endpoints require Ed25519 signature authentication.

ENDPOINTS

GET/node/status

Get Node Status

Retrieve the current operational status of an immune node, including stake, network participation, and threat response metrics.

Authentication

Ed25519 signature required in Authorization header

Parameters

None (optional: node_id query parameter for specific node)

Response

{
  "node_id": "0x...",
  "status": "ACTIVE",
  "stake_deployed": 1000000,
  "network_participation": 98.5,
  "threat_responses_executed": 42,
  "last_heartbeat": 1623456789,
  "cryptographic_proof": "0x..."
}

Error Codes

400: Invalid node_id
401: Authentication failed
404: Node not found

Example Request

curl -X GET https://api.synthos.io/node/status   -H "Authorization: Bearer <ed25519_signature>"