{"uid":"cap_TZ_ZTmjA_cOYym3aphpQz","slug":"brainiac-electricity-market-price-series-normalize-0b5b8f65","name":"BRAINIAC Electricity Market Price Series Normalize","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/electricity-market/price-series-normalize?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"feed":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":500}},"additionalProperties":false},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kwh":{"type":"number","maximum":1000000000,"minimum":0},"peakKw":{"type":"number","maximum":1000000000,"minimum":0},"source":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"tariffId":{"type":"string","maxLength":80},"periodEnd":{"type":"string","maxLength":40},"billedFixed":{"type":"number","maximum":1000000000,"minimum":0},"billedTotal":{"type":"number","maximum":1000000000,"minimum":0},"periodStart":{"type":"string","maxLength":40},"billedDemand":{"type":"number","maximum":1000000000,"minimum":0},"billedEnergy":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"carbon":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"index":{"type":"string","maxLength":40},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"intensity":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":1000},"demand":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"mw":{"type":"number","maximum":1000000000,"minimum":0},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200}},"additionalProperties":false},"maxItems":1000},"prices":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"price":{"type":"number","maximum":1000000,"minimum":-1000000},"market":{"type":"string","maxLength":120},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"product":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12}},"additionalProperties":false},"maxItems":1000},"outages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cause":{"type":"string","maxLength":200},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"status":{"type":"string","maxLength":80},"endedAt":{"type":"string","maxLength":40},"startedAt":{"type":"string","maxLength":40},"customersAffected":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500},"tariffs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":160},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"currency":{"type":"string","maxLength":12},"demandUnit":{"type":"string","maxLength":40},"energyRate":{"type":"number","maximum":1000000,"minimum":0},"fixedCharge":{"type":"number","maximum":1000000000,"minimum":0},"peakDemandRate":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":100},"exposures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"market":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"volumeMwh":{"type":"number","maximum":1000000000,"minimum":0},"hedgeRatio":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},"maxItems":100},"worldBank":{"type":"object","properties":{"country":{"type":"string","maxLength":3,"minLength":2},"perPage":{"type":"integer","maximum":60,"minimum":1},"indicator":{"type":"string","maxLength":80,"minLength":3}},"additionalProperties":false},"generation":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"mw":{"type":"number","maximum":1000000000,"minimum":0},"fuel":{"type":"string","maxLength":80},"region":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"isForecast":{"type":"boolean"}},"additionalProperties":false},"maxItems":1000},"carbonIntensity":{"type":"object","properties":{"fetch":{"type":"boolean"},"forecast":{"type":"boolean"},"regionId":{"type":"integer","maximum":18,"minimum":1}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"items":[{"at":"2026-11-01T12:00:00.000Z","id":"P1","unit":"currency/MWh","price":78.5,"market":"N2EX","region":"GB","source":"Caller-supplied","product":"day-ahead","currency":"GBP","priceSupplied":true,"apiKeyRequired":false,"paidProviderUsed":false},{"at":"2026-11-02T12:00:00.000Z","id":"P2","unit":"currency/MWh","price":82.1,"market":"N2EX","region":"GB","source":"Caller-supplied","product":"day-ahead","currency":"GBP","priceSupplied":true,"apiKeyRequired":false,"paidProviderUsed":false}],"status":"normalized","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","pointCount":2,"limitations":["Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.","No paid energy data provider is used and no API key is required.","Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.","Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.","Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."],"publicSources":[],"apiKeyRequired":false,"forecastInvented":false,"paidProviderUsed":false,"billingAccuracyClaimed":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AoiM6obUskX0-NwbGL-ZE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Accepts caller-supplied electricity price, demand, carbon, tariff, billing, and generation data and normalizes it into a structured, timestamped price series without inventing missing values.","exampleAgentPrompt":"I have a CSV of day-ahead electricity prices from N2EX in GBP/MWh covering November 2026 — can you normalize it into a structured price series with timestamps, market, region, currency, and unit fields so I can feed it into our analytics pipeline?","exampleUseCases":[{"title":"Normalize wholesale market price CSV","prompt":"I've got a messy CSV export of GB day-ahead electricity prices from N2EX for October and November 2026, prices in GBP/MWh — can you normalize it into a clean timestamped price series with market, region, and currency fields?"},{"title":"Unify multi-source energy billing data","prompt":"I have electricity bill records from three sites with different tariff IDs and billing periods — can you normalize them into a unified price series so I can compare energy costs across sites by period?"},{"title":"Structure carbon-intensity-linked price data","prompt":"I have hourly electricity price data alongside carbon intensity readings for the UK grid for the past week — please normalize all of it into a structured series with timestamps, price in GBP/MWh, carbon intensity, and region so I can run a correlation analysis."}],"resultDescription":"Returns a JSON object with an `items` array of normalized price records (each containing timestamp, ID, unit, price, market, region, source, product, currency, and flags such as priceSupplied, apiKeyRequired, and paidProviderUsed), plus metadata fields: status, findings, checkedAt, pointCount, limitations, publicSources, and audit flags (forecastInvented, paidProviderUsed, billingAccuracyClaimed). Missing values are never invented.","failureModes":["Malformed or unrecognized CSV/JSON input returns an error or empty items array","Input exceeding size limits (200,000 chars for text/csv/json, 12MB for file) is rejected","Missing required file fields (mediaType, fileBase64) cause validation errors","Unreachable feed URL results in a fetch error and no price data from that source","Records with out-of-range numeric values (e.g. negative kWh) are rejected by schema validation","Ambiguous or unparseable date/time strings in periodStart/periodEnd or `at` fields cause row-level errors"],"whenToPreferThis":"Use this endpoint when you have caller-supplied electricity market data (prices, bills, demand, carbon intensity, generation, tariffs, outages) in various raw formats (CSV, JSON, text, file, structured arrays, or a URL feed) and need a normalized, auditable, timestamped price series with no invented values and clear provenance flags. Prefer this over general-purpose data transformation tools when you specifically need electricity-domain semantics (MWh units, market/region/product metadata, carbon intensity linkage, tariff and billing alignment) and when auditability (paidProviderUsed, forecastInvented, billingAccuracyClaimed flags) is important. It is especially suitable for agents building energy analytics pipelines, compliance reporting, or multi-source energy cost comparisons.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:50.337Z","isFirstParty":false,"canonicalSlug":"brainiac-electricity-market-price-series-normalize-0b5b8f65"}