# BRAINIAC Open Banking Transaction Classifier

> BRAINIAC Open Banking Transaction Classifier is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Classifies and categorizes open banking transactions from raw CSV, JSON, or structured data into labeled categories like income, groceries, and subscriptions without requiring bank credentials.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/payment-intelligence/open-banking-transaction-classify?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-open-banking-transaction-classifier-086adc6b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AbNlciWw48wCscpIMjIWU

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-open-banking-transaction-classifier-086adc6b -d '<json body>'
```

Example prompt: Can you classify these bank transactions from my CSV export into categories like income, groceries, and subscriptions? Here's the data — I want each transaction labeled with a category and merchant name without connecting to any live bank account.

## When to prefer this

Choose this endpoint when you need to classify and enrich open banking transaction data without connecting to a live bank account or supplying credentials. It is ideal for fintech applications, personal finance agents, compliance tools, or affordability pre-checks that work from exported or supplied transaction data (CSV, JSON, or structured arrays). Prefer it over general-purpose LLM-based classification when you need a structured, auditable output with explicit limitations disclosures and merchant normalization. It is a pay-per-call API requiring no account setup, making it suitable for sporadic or agent-driven usage.

## Known failure modes

- Malformed or unparseable CSV/JSON input returns an error
- Transactions missing required fields may be skipped or partially classified
- Ambiguous merchant names may result in unknown merchant classification
- Exceeding maxItems (100 accounts, 400 merchants, 400 corrections) causes input rejection
- Missing asOf date may affect recency-sensitive classification logic
- Very large file uploads (>12MB base64) will be rejected
- Payment failure via x402 results in 402 response before processing

## 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 an array of classified transaction items, each enriched with category, merchant, currency, direction, and categorySource fields. Also includes a status field ('classified'), checkedAt timestamp, itemCount, a findings array for anomalies, and a limitations array explaining what was and was not inferred. Flags like bankConnected, openBankingConnected, incomeInvented, credentialsRequired, and affordabilityDecision confirm that no live bank credentials were used and no affordability decisions were made.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "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
  },
  "accounts": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 200
     },
     "type": {
      "type": "string",
      "maxLength": 80
     },
     "currency": {
      "type": "string",
      "maxLength": 12
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100
  },
  "merchants": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 200
     },
     "aliases": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 200
      },
      "maxItems": 20
     },
     "category": {
      "type": "string",
      "maxLength": 120
     }
    },
    "additionalProperties": false
   },
   "maxItems": 400
  },
  "corrections": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "to": {
      "type": "string",
      "maxLength": 120
     },
     "from": {
      "type": "string",
      "maxLength": 120
     },
     "merchant": {
      "type": "string",
      "maxLength": 200
     },
     "transactionId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 400
  },
  "transactions": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "mcc": {
      "type": "string",
      "maxLength": 20
     },
     "date": {
      "type": "string",
      "maxLength": 40
     },
     "amount": {
      "type": "n
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "TX-1",
    "date": "2026-10-01",
    "amount": 3200,
    "status": "",
    "category": "income",
    "currency": "GBP",
    "merchant": "",
    "accountId": "ACC-1",
    "reference": "",
    "description": "ACME payroll salary",
    "bankConnected": false,
    "amountSupplied": true,
    "categorySource": "token_match",
    "suppliedCategory": "income",
    "openBankingConnected": false
   },
   {
    "id": "TX-2",
    "date": "2026-10-03",
    "amount": -14.99,
    "status": "",
    "category": "subscription",
    "currency": "GBP",
    "merchant": "Netflix",
    "accountId": "ACC-1",
    "reference": "",
    "description": "Netflix subscription",
    "bankConnected": false,
    "amountSupplied": true,
    "categorySource": "token_match",
    "suppliedCategory": "",
    "openBankingConnected": false
   },
   {
    "id": "TX-3",
    "date": "2026-10-04",
    "amount": -62.4,
    "status": "",
    "category": "groceries",
    "currency": "GBP",
    "merchant": "Tesco",
    "accountId": "ACC-1",
    "reference": "",
    "description": "Tesco groceries",
    "bankConnected": false,
    "amountSupplied": true,
    "categorySource": "token_match",
    "suppliedCategory": "",
    "openBankingConnected": false
   }
  ],
  "status": "classified",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "itemCount": 3,
  "limitations": [
   "Transactions, accounts, merchants, and category corrections are copied only from labeled fields supplied by the caller.",
   "No bank account is connected and no Open Banking credentials are required or used.",
   "Income, affordability, and merchant identity are derived only from supplied rows. Missing values are not invented.",
   "Recurring and subscription detection use date spacing and description/merchant similarity from the supplied set only.",
   "An affordability or credit decision is never produced."
  ],
  "bankConnected": false,
  "incomeInvented": false,
  "credentialsRequired": false,
  "openBankingConnected": false,
  "affordabilityDecision": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-open-banking-transaction-classifier-086adc6b/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)
