{"uid":"cap_YA5yxKEvnKpagozIw4L42","slug":"brainiac-cloud-finops-spend-breakdown-0eaf551c","name":"BRAINIAC Cloud FinOps Spend Breakdown","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/cloud-finops/spend-breakdown?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000,"minLength":1},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/csv","text/plain"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"rows":{"type":"array","items":{"type":"object","required":["date","service","cost","currency"],"properties":{"cost":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"tags":{"type":"array","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string","maxLength":80,"minLength":1},"value":{"type":"string","maxLength":200,"minLength":1}},"additionalProperties":false},"maxItems":20},"region":{"type":"string","maxLength":80,"minLength":1},"account":{"type":"string","maxLength":80,"minLength":1},"service":{"type":"string","maxLength":120,"minLength":1},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"usageUnit":{"type":"string","maxLength":40,"minLength":1},"resourceId":{"type":"string","maxLength":200,"minLength":1},"resourceType":{"type":"string","maxLength":80,"minLength":1},"usageQuantity":{"type":"number","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":5000},"tagKey":{"type":"string","maxLength":80,"minLength":1},"groupBy":{"enum":["service","region","account"],"type":"string"}}},"responseSchema":{"type":"json","example":{"trend":[{"change":10,"status":"compared","currency":"USD","latestCost":120,"latestMonth":"2026-03","previousCost":110,"previousMonth":"2026-02"}],"groups":[{"key":"compute","cost":210,"share":0.636364,"currency":"USD"},{"key":"storage","cost":120,"share":0.363636,"currency":"USD"}],"status":"grouped","findings":[{"code":"no_fx","kind":"extracted","detail":"Currencies are not converted."}],"checkedAt":"2026-11-02T19:00:00.000Z","groupedBy":"service","limitations":["No cloud account was connected and no infrastructure was changed.","Costs and forecasts use only figures supplied in the request.","Provider list prices are not added, and no saving is claimed without a supplied cost.","The billing format is brainiac-billing-v1. Native provider exports are not accepted."],"accountConnected":false,"infrastructureChanged":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JVanHBS8Q13Omm1ZMvhmP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes cloud cost data to produce a grouped spend breakdown with trend analysis and key findings, given raw billing rows, a CSV, or a base64-encoded file.","exampleAgentPrompt":"Can you break down my cloud costs by service and show me month-over-month trends? Here's my billing data as CSV rows with date, service, cost, and currency fields for Feb and Mar 2026.","exampleUseCases":[{"title":"Monthly cloud spend report by service","prompt":"I have my cloud billing data for the last two months as a CSV. Can you group all costs by service, show each service's share of total spend, and flag any notable month-over-month changes?"},{"title":"Regional cost hotspot detection","prompt":"Here's my infrastructure billing as a list of rows with dates, regions, and costs in USD — can you group this by region and tell me which region is driving the most spend and how it's trended compared to last month?"},{"title":"Multi-account cost allocation audit","prompt":"I need to audit cloud costs across our accounts. I'll give you a base64-encoded CSV export — please group it by account, show each account's percentage share of total spend, and highlight any accounts where costs jumped significantly."}],"resultDescription":"Returns a JSON object with: (1) 'groups' array — each dimension key (service/region/account), its total cost, share of overall spend, and currency; (2) 'trend' array — comparison of latest vs previous month cost with absolute change and status; (3) 'findings' array — extracted insights or data quality notes; (4) 'limitations' list — caveats about the analysis scope; (5) metadata fields including groupedBy, checkedAt, accountConnected, and infrastructureChanged flags.","failureModes":["Invalid or missing required fields (date, service, cost, currency) in rows — returns validation error","CSV or file exceeds size limits (200,000 chars for csv, 12MB base64 for file) — rejected","Unsupported groupBy value outside enum (service/region/account) — validation error","No input provided (no csv, file, or rows) — returns error","Mixed currencies without conversion — returned as 'no_fx' finding rather than error","Payment of 0.03 USDC on Base not completed — 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you have raw cloud billing data (rows, CSV, or file) and need a structured spend breakdown grouped by service, region, or account with trend analysis — without connecting a live cloud account. Ideal for one-off audits, agent-driven FinOps pipelines, or when you want to avoid provisioning cloud cost management credentials. Best when data is in the brainiac-billing-v1 format with date/service/cost/currency fields.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:36:57.322Z","isFirstParty":false,"canonicalSlug":"brainiac-cloud-finops-spend-breakdown-0eaf551c"}