REST API

The AxonInfra API allows you to programmatically ingest signals, update policies, and query allocation decisions. All endpoints are prefixed with /v1.

Authentication

Authenticate requests by including your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Signals

POST

/signals/ingest

Ingest power market data or local telemetry.

Request Body

{
  "timestamp": "2026-01-01T12:00:00Z",
  "power_price_usd_per_mwh": 85.50,
  "grid_event": "none",
  "hpc_queue_depth": 3,
  "active_miners": 150
}

Response

{
  "status": "success",
  "data": {
    "signal_id": "sig_123456789",
    "processed_at": "2026-01-01T12:00:01Z"
  }
}

Policy

POST

/policy/decide

Trigger a policy evaluation based on provided or stored signals.

Allocations

GET

/allocations/history

Retrieve historical allocation decisions for auditing.