# BRAINIAC Cloud FinOps Budget Variance Analyzer

> BRAINIAC Cloud FinOps Budget Variance Analyzer is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-17).

Analyzes cloud cost data against a defined budget to compute variance, identify overspend, and surface FinOps findings for a given period.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/cloud-finops/budget-variance-analyze?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-cloud-finops-budget-variance-analyzer-9bf8c5b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mFooeAhvj_oGtVFStU6QJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-cloud-finops-budget-variance-analyzer-9bf8c5b5 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-cloud-finops-budget-variance-analyzer-9bf8c5b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
