{"uid":"cap_mFooeAhvj_oGtVFStU6QJ","slug":"brainiac-cloud-finops-budget-variance-analyzer-9bf8c5b5","name":"BRAINIAC Cloud FinOps Budget Variance Analyzer","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/budget-variance-analyze?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},"budget":{"type":"object","required":["amount","currency","periodStart","periodEnd"],"properties":{"amount":{"type":"number","maximum":1000000000000,"minimum":0},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"periodEnd":{"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])))$"},"periodStart":{"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])))$"}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"actual":330,"budget":300,"status":"partial","currency":"USD","findings":[{"code":"budget_partial","kind":"insufficient","detail":"The period has 90 days and the charges cover 3. The variance uses only the supplied rows."},{"code":"budget_variance","kind":"extracted","detail":"Actual 330 minus budget 300 is 30 USD."}],"variance":30,"checkedAt":"2026-11-02T19:00:00.000Z","periodDays":90,"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."],"coverageDays":3,"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_MoRnBhYws_uBTM_-ThtAo","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 against a defined budget to compute variance, identify overspend, and surface FinOps findings for a given period.","exampleAgentPrompt":"Analyze my cloud costs for Q1 2025 against a budget of $10,000 USD — I have cost rows for AWS EC2 and S3 from January through March. Tell me the variance, whether I'm over or under budget, and flag any key findings.","exampleUseCases":[{"title":"Monthly AWS spend vs budget review","prompt":"I have my AWS cost data for October 2024 as a CSV — 150 rows covering EC2, RDS, and S3 — and my monthly budget was $5,000 USD from October 1 to October 31. Can you compute the budget variance and tell me if I overspent, and by how much?"},{"title":"Multi-service quarterly FinOps report","prompt":"Run a budget variance analysis on my cloud costs for Q3 2025, covering GCP Compute and BigQuery services. My budget was $25,000 USD from July 1 to September 30. Here are the cost rows — flag any findings about where the spend diverged from plan."},{"title":"Spot-check team cloud budget mid-period","prompt":"My team has a $3,000 USD cloud budget running from December 1 to December 31 and we're halfway through. I have cost rows for the first 15 days — can you calculate our variance so far and tell me if we're on track or heading over budget?"}],"resultDescription":"Returns a JSON object with the actual total spend, the budget amount, variance (actual minus budget), status (e.g. partial, over, under), period days, coverage days, a findings array with coded FinOps observations (e.g. budget_variance, budget_partial), a checkedAt timestamp, and a limitations list clarifying that only supplied data is used (no live cloud account connection).","failureModes":["Missing required budget fields (amount, currency, periodStart, periodEnd) causes validation error","No cost data provided (neither csv, file, nor rows) results in an error or empty analysis","CSV or base64 file exceeds size limits (200,000 chars or 12MB) causes rejection","Invalid date format in rows or budget period triggers schema validation failure","Currency code not matching 3-letter ISO pattern causes rejection","Insufficient coverage days relative to period length results in 'partial' status with a warning finding","Payment not completed via x402/USDC on Base results in 402 response with no analysis"],"whenToPreferThis":"Use this endpoint when you need a quick, accountless cloud cost variance computation against a predefined budget using data you already have (rows, CSV, or file upload). Ideal for agents operating in FinOps workflows that need to flag budget overruns without connecting live cloud accounts. Best when cost data is in the brainiac-billing-v1 format and you want structured findings with variance codes rather than a narrative summary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:37:09.716Z","isFirstParty":false,"canonicalSlug":"brainiac-cloud-finops-budget-variance-analyzer-9bf8c5b5"}