ENERGY.md

Universal Energy API for Autonomous Systems — a blended abstraction over solar, wind, nuclear, hydro, fossil, batteries, and surplus.

Part of the protocols.md network
Draft v0.1 - Lightweight brainstorming for the energy settlement layer. This is exploratory speculation about how autonomous agents might coordinate energy resources. RFC stage

Problem

Energy markets are fragmented across incompatible protocols and interfaces:

  • Grid operators rely on legacy SCADA stacks (IEC 61850, DNP3).
  • Bitcoin miners expose 20GW of stranded capacity with no standardized API.
  • Power plants speak Modbus or proprietary control languages.
  • Battery farms tie access to manufacturer-specific BMS systems.
  • Nuclear SMRs are coming online without any programmatic endpoint.

There is no unified abstraction layer for comparing prices, booking capacity, or executing trades across all energy types.

Solution – Blended Abstraction Layer

GET https://energy.md/discover
Loading...

energy.md normalizes solar, wind, nuclear, hydro, fossil, battery, and miner surplus into a single, agent-native schema. Every source looks the same at the protocol level — queryable, comparable, and bookable.

Core APIs

Discovery

GET /sources?min_mw=100&max_price=50&location=us-west

Find available power by capacity, price, location, reliability — regardless of whether the backend is solar, gas, or nuclear.

Bitcoin Miner Integration

{
  "endpoint": "/btc-miners",
  "description": "Monetize mining downtime",
  "providers": [
    {
      "id": "riot_platforms_texas",
      "capacity_mw": 700,
      "price_mwh": 2.80,
      "btc_mining": "paused",
      "availability": "immediate"
    },
    {
      "id": "marathon_digital_montana",  
      "flare_gas_mw": 280,
      "price_mwh": 3.50,
      "uptime": 0.98
    }
  ]
}

Real-time Booking

POST /book
{
  "buyer": "anthropic_training_cluster_7",
  "mw_required": 100,
  "duration_hours": 168,
  "start": "2024-01-15T00:00:00Z"
}

Power Sources (abstracted)

Source TypeCapacity (GW)$/MWhAvailability
Bitcoin Miners20$2.80Immediate
Natural Gas450$45On-demand
Nuclear95$65Baseload
Hydro80$38Seasonal
Solar150$31Daylight
Wind140$28Variable

All sources are surfaced through one endpoint, instead of siloed contracts and protocols.

Why This Matters

Today, procuring 50 GWh for a GPT-5-scale run requires manual PPAs, fragmented negotiations, and no cross-region optimization.

With energy.md, power becomes a universal digital primitive:

  • Bookable in real time
  • Cross-source arbitrageable
  • Composable for agents

Integration Example

# AI training cluster needs 100MW for a week
import requests

sources = requests.get('https://energy.md/discover', {
    'mw_needed': 100,
    'duration_hours': 168,
    'include_miners': True
}).json()

deal = requests.post('https://energy.md/book', {
    'source_id': sources['cheapest']['id'],
    'mw': 100,
    'hours': 168
}).json()

print(f"Secured {deal['mw']} MW at $\{deal['total_cost']:,}")
print(f"Source: {deal['provider_type']}")

Network Effects

Once energy.md becomes the default blended endpoint:

  • Price Discovery – Universal cross-source pricing.
  • Miner Revenue – New off-takers beyond Bitcoin.
  • Grid Efficiency – AI demand response as a stabilizer.
  • SMR Deployment – Standardized interface to datacenter buyers.
  • Stranded Assets – Monetization of trapped energy everywhere.
spec_version: 0.1.0-draft
published: 2025-09-03T20:17:43-07:00
content_hash: sha256:a7f4c8e9d2b1f6a3e8c5d9f2a6b4e7c1d8f5a2c9e6b3f7a4d1c8e5b2f9a6c3d7
status: brainstorming
contact: proofmdorg@gmail.com

energy.md

© 2025 energy.md authors · MIT License · Exploratory specification