Gradient Schema

Example Response

{
  "actor_id": "dc-west-07",
  "actor_type": "datacenter",
  "region": "us-west-2",
  "ts": "2026-01-24T14: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
  }
}

OpenAPI

openapi: 3.0.0
info:
  title: EGS
  version: 1.0.0
paths:
  /egs/v1/gradient:
    get:
      summary: Expose gradient
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                required:
                  - actor_id
                  - actor_type
                  - region
                  - ts
                  - marginal_capacity_kw
                  - instantaneous_cost_index
                  - thermodynamic_priority
                  - constraints
                properties:
                  actor_id:
                    type: string
                  actor_type:
                    type: string
                    enum: [enterprise, datacenter, grid, robot, asi]
                  region:
                    type: string
                  ts:
                    type: string
                    format: date-time
                  marginal_capacity_kw:
                    type: number
                  instantaneous_cost_index:
                    type: number
                    minimum: 0
                    maximum: 1
                  thermodynamic_priority:
                    type: number
                    minimum: 0
                    maximum: 1
                  constraints:
                    type: object
                    properties:
                      max_delta_kw:
                        type: number
                      ramp_rate_kw_per_min:
                        type: number
                      thermal_headroom_pct:
                        type: number