{
  "name": "ELEC Finance — $ELEC US Electricity Price API",
  "description": "Real-time US national electricity price index in USD/MWh. Liquidity-weighted composite of 12 major ICE power hub contracts, updated every 0.5 seconds. No accounts or API keys — access purchased per session in USDC via x402 protocol.",
  "version": "1.0.0",
  "url": "https://elec.finance",
  "api_base_url": "https://api.elec.finance",
  "sandbox_url": "https://sandbox.elec.finance",
  "openapi_url": "https://elec.finance/openapi.json",
  "llms_txt": "https://elec.finance/llms.txt",
  "documentation_url": "https://elec.finance/docs",
  "status_url": "https://elec.finance/status",
  "contact": "api@elec.finance",
  "auth": {
    "type": "x402",
    "description": "Access purchased per session using the x402 protocol. Client pays USDC on Base network; server issues a signed JWT session token.",
    "payment_asset": "USDC",
    "payment_network": "base-mainnet",
    "x402_library_npm": "coinbase/x402",
    "x402_library_python": "x402-python",
    "token_header": "Authorization",
    "token_format": "Bearer <JWT>",
    "token_query_param": "token"
  },
  "endpoints": [
    {
      "path": "/api/elec/stream/access",
      "method": "POST",
      "description": "Initiate x402 payment flow to obtain a JWT session token.",
      "auth_required": false,
      "triggers_payment": true
    },
    {
      "path": "/api/elec/price",
      "method": "GET",
      "description": "JSON snapshot of the current $ELEC index price. Recommended for AI agents.",
      "auth_required": true,
      "response_format": "application/json"
    },
    {
      "path": "/api/elec/stream",
      "method": "GET",
      "description": "SSE stream delivering $ELEC price ticks every 0.5 seconds.",
      "auth_required": true,
      "response_format": "text/event-stream"
    },
    {
      "path": "/api/elec/status",
      "method": "GET",
      "description": "Feed health check. No authentication required.",
      "auth_required": false,
      "response_format": "application/json"
    }
  ],
  "data": {
    "asset": "$ELEC",
    "description": "US National Electricity Price Index",
    "unit": "USD/MWh",
    "update_frequency_ms": 500,
    "input_markets": 12,
    "methodology": "Liquidity-weighted bid/ask mid-price composite across 12 ICE US power hub futures contracts"
  },
  "tags": [
    "electricity",
    "energy",
    "price-feed",
    "real-time",
    "commodities",
    "trading",
    "finance",
    "x402",
    "usdc",
    "power-markets",
    "ICE",
    "USD/MWh"
  ],
  "mcp_server": {
    "url": "https://mcp.elec.finance",
    "tools": ["get_current_price", "get_feed_status", "get_historical_prices"]
  }
}
