# BRAINIAC Recurring Payment Detection API

> BRAINIAC Recurring Payment Detection API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-14).

Analyzes a set of financial transactions to detect recurring payments and subscriptions by identifying repeating amounts, merchants, and date-spacing patterns.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/payment-intelligence/recurring-detect?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-recurring-payment-detection-api-f832e3ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GiBmTqk4bK7xQdoGvnmBQ

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-recurring-payment-detection-api-f832e3ba -d '<json body>'
```

Example prompt: Can you go through these transactions and find any recurring payments or subscriptions — I want to know what's being charged regularly, how often, and which merchants are involved?

## When to prefer this

Use this endpoint when you need to detect subscriptions and recurring charges from a supplied set of transaction records without connecting to any bank account or Open Banking provider. It is ideal for fintech agents, personal finance tools, or compliance workflows that already have transaction data and need fast, privacy-preserving recurring payment analysis. Prefer it over open-banking-integrated solutions when you do not have or want to handle bank credentials, or when working with synthetic, exported, or third-party transaction data.

## Known failure modes

- Insufficient transactions to establish a pattern (fewer than ~3 occurrences) resulting in no recurring items detected
- Ambiguous merchant names or missing description fields reducing match accuracy
- Truncated or malformed CSV/JSON input causing parse errors
- Transactions spanning too short a time window to confirm cadence
- Amount variability above threshold preventing recurring classification

## 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 list of detected recurring payment items, each with merchant name, amount, currency, cadence label (e.g. monthly_candidate), first/last date, average gap in days, gap standard deviation, occurrence count, and transaction IDs. Also includes overall status, findings with observation codes, limitations disclaimer, and flags indicating whether bank or Open Banking credentials were used (always false — no credentials required).

## 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": [
   {
    "key": "netflix|14.99|gbp",
    "amount": 14.99,
    "cadence": "monthly_candidate",
    "currency": "GBP",
    "gapStdev": 0.71,
    "lastDate": "2026-10-03",
    "merchant": "Netflix",
    "direction": "debit",
    "firstDate": "2026-08-03",
    "recurring": true,
    "bankConnected": false,
    "averageGapDays": 30.5,
    "transactionIds": [
     "TX-1",
     "TX-2",
     "TX-3"
    ],
    "occurrenceCount": 3,
    "gapStdevSupplied": true,
    "openBankingConnected": false,
    "averageGapDaysSupplied": true
   }
  ],
  "status": "detected",
  "findings": [
   {
    "code": "recurring_candidate",
    "kind": "observation",
    "detail": "A repeating amount and date spacing pattern was found in supplied transactions.",
    "subject": "Netflix"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "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,
  "recurringCount": 1,
  "credentialsRequired": false,
  "openBankingConnected": false,
  "affordabilityDecision": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-recurring-payment-detection-api-f832e3ba/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)
