EGS Signal → ECU Contract → Settlement
Marginal energy actionability exposed. Physical constraints included.
GET /egs/v1/gradient{
"actor_id": "dc-west-07",
"actor_type": "datacenter",
"region": "us-west-2",
"ts": "2025-01-15T14:32:00Z",
"marginal_capacity_kw": 4200,
"instantaneous_cost_index": 0.38,
"thermodynamic_priority": 0.72,
"constraints": {
"max_delta_kw": 800,
"ramp_rate_kw_per_min": 150,
"thermal_headroom_pct": 18.5
}
}
ECU = 1 kWh × 1 GPU-second. Energy × compute.
Gradient-based capacity becomes purchasable. Price locked on allocation.
POST /egs/v1/quote POST /egs/v1/allocatePOST /egs/v1/quote
Request:
{
"region": "eu-west",
"window_sec": 3600,
"ecu_qty": 10000,
"currency_code": "USD"
}
Response:
{
"quote_id": "uuid",
"currency_code": "USD",
"price_per_ecu": 0.42,
"ecu_qty": 10000
}
POST /egs/v1/allocate
Request:
{
"quote_id": "q-8a3f"
}
Response:
{
"allocation_id": "a-7c2d",
"ecu_qty": 10000,
"currency_code": "USD",
"price_per_ecu": 0.42,
"status": "reserved"
}
Metering hash verification. Delivered ECU accounting. USD settlement. Ed25519 signed receipts.
POST /egs/v1/receiptPOST /egs/v1/receipt
Request:
{
"allocation_id": "a-7c2d",
"ecu_delivered": 4850,
"metering_hash": "sha256:9f86d08..."
}
Response:
{
"receipt_id": "r-3b4c",
"ecu_allocated": 10000,
"ecu_delivered": 9700,
"currency_code": "USD",
"settlement_amount": 4074.00,
"signature": "ed25519:..."
}
gradient execution → ECU emission → currency settlement