{"openapi":"3.1.0","info":{"title":"Watt Street API","version":"1.0.0","description":"US grid, interconnection-queue and data-center intelligence. Agent-native: self-serve keys, metered credits, x402 machine payments, MCP tools. No human required at any step.","contact":{"email":"hello@wattstreet.net","url":"https://wattstreet.net"},"license":{"name":"Attribution required","url":"https://wattstreet.net/how-we-make-it"}},"servers":[{"url":"https://api.wattstreet.net"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Get a key instantly: POST https://api.wattstreet.net/v1/keys"}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/keys":{"post":{"operationId":"createApiKey","summary":"Self-serve API key — instant, no human approval","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent_name":{"type":"string"},"operator":{"type":"string"}}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/me":{"get":{"operationId":"getAccount","summary":"Key status and credit balance","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/checkout":{"post":{"operationId":"createOrder","summary":"Machine checkout — x402 or card","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","enum":["credits_10k","credits_100k","pro_month","partner_year"]}}}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/map":{"get":{"operationId":"getMap","summary":"GeoJSON of grid activity for rendering maps","parameters":[{"name":"layer","in":"query","schema":{"type":"string","enum":["all","generation","load","datacenters"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Credits exhausted — x402 challenge"}}}},"/mcp":{"post":{"operationId":"mcp","summary":"MCP 2026-07-28 (stateless Streamable HTTP)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/summary":{"get":{"operationId":"get_summary","summary":"Watt Street summary","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/regions":{"get":{"operationId":"get_regions","summary":"Watt Street regions","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/counties":{"get":{"operationId":"get_counties","summary":"Watt Street counties","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/projects":{"get":{"operationId":"get_projects","summary":"Watt Street projects","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/loads":{"get":{"operationId":"get_loads","summary":"Watt Street loads","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/datacenters":{"get":{"operationId":"get_datacenters","summary":"Watt Street datacenters","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/policy":{"get":{"operationId":"get_policy","summary":"Watt Street policy","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/lobbying":{"get":{"operationId":"get_lobbying","summary":"Watt Street lobbying","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}},"/v1/sources":{"get":{"operationId":"get_sources","summary":"Watt Street sources","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"API key required"},"402":{"description":"Credits exhausted"}}}}}}