# BRAINIAC Cloud FinOps Spend Breakdown

> BRAINIAC Cloud FinOps Spend Breakdown 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 to produce a grouped spend breakdown with trend analysis and key findings, given raw billing rows, a CSV, or a base64-encoded file.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/cloud-finops/spend-breakdown?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-spend-breakdown-0eaf551c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YA5yxKEvnKpagozIw4L42

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-spend-breakdown-0eaf551c -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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: (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.

## 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
  },
  "tagKey": {
   "type": "string",
   "maxLength"
… (truncated)
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-cloud-finops-spend-breakdown-0eaf551c/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)
