{"uid":"cap_846mKHfxDClmxLSlybLz1","slug":"netzhandwerker-grid-events-stream-d4b60ea7","name":"Netzhandwerker Grid Events Stream","description":"Live electricity prices, carbon intensity, grid load, renewable share, flexibility windows, battery arbitrage, trading signals and ESG reporting for autonomous agents.","url":"https://energy.netzhandwerker.de/events/grid","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BHLj20GrFdpApr-j9cWZT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Streams real-time grid events including electricity prices, carbon intensity, renewable share, flexibility windows, and battery arbitrage signals for a given energy market region.","exampleAgentPrompt":"What are the current grid events for the German energy market — give me live electricity prices, carbon intensity, renewable share, and any battery arbitrage or flexibility windows active right now.","exampleUseCases":[{"title":"Optimize data center power consumption","prompt":"Monitor the grid carbon intensity for our region in real time and let me know when it drops below 100g CO2/kWh so we can schedule our data processing jobs during cleaner energy windows."},{"title":"Maximize residential battery profits","prompt":"Watch the electricity price spread right now and alert me whenever there's a gap of at least 15 cents between the current price and the forecasted peak — that's when I want to charge my home battery for arbitrage."},{"title":"Schedule factory operations for ESG goals","prompt":"Give me a live update on the renewable energy share in our grid, flexibility windows available today, and what the carbon intensity is looking like so I can plan when to run our heavy machinery and report accurate sustainability metrics."}],"resultDescription":"Returns a stream of grid events for the requested market region, including spot electricity prices, carbon intensity values, current grid load percentage, renewable energy share, identified flexibility windows for demand response, battery arbitrage opportunity signals, energy trading signals, and ESG reporting metrics.","failureModes":["Invalid or unsupported grid region returns 400 with region validation error","Payment not received or insufficient USDC balance returns 402 Payment Required","Upstream grid data provider unavailable returns 503 with retry guidance","Malformed event filter parameters return 422 with field-level validation errors","Rate limit exceeded returns 429 with backoff instructions"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time grid-level intelligence for energy optimization decisions — such as scheduling battery charge/discharge cycles, timing high-load operations for low-carbon or low-cost windows, generating ESG reports, or executing energy trading strategies. Prefer this over static pricing APIs when live signal freshness and multi-dimensional grid data (price + carbon + renewables + flexibility) are all required simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:49:11.624Z","isFirstParty":false}