# BRAINIAC Marketplace Payout Hold Diagnostics

> BRAINIAC Marketplace Payout Hold Diagnostics 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-11).

Analyzes marketplace payout hold records, notices, policies, and evidence to diagnose the reason for a hold and assess its status without accessing live accounts.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/marketplace-health/payout-hold-diagnose?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-marketplace-payout-hold-diagnostics-2d780258
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TJZ-5Cm8_1S2KPuuSTUrl

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-marketplace-payout-hold-diagnostics-2d780258 -d '<json body>'
```

Example prompt: I have a payout hold on my seller account — the hold ID is H-1001, it's been active since March 15, the amount is $320 USD, and the stated reason is 'listing policy violation'. I also have a notice from the marketplace demanding corrective action by April 30. Can you diagnose what's going on with this hold and whether there's a path to resolving it?

## When to prefer this

Use this endpoint when an AI agent needs to interpret and diagnose marketplace payout holds from documents, records, and notices already in hand — without needing live account access. Ideal for seller support workflows, pre-appeal analysis, or compliance audits where structured hold records, notices, and policy texts can be supplied as input. Prefer this over general-purpose LLM analysis when you need deterministic, field-by-field findings with explicit limitation disclosures and structured JSON output.

## Known failure modes

- Missing required hold data — if no holds or notices are supplied, findings will be sparse or empty
- Policy not matched — if no policy text is included, hold-to-policy matching is skipped and noted in limitations
- Truncated CSV/JSON input — inputs exceeding 200,000 character limits will be rejected
- Ambiguous hold reasons — empty reason fields are flagged as missing rather than inferred
- No live data — the endpoint never contacts a marketplace or seller account, so real-time hold status is not reflected

## 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 structured JSON object including: a list of diagnosed hold records with interpretations, a status field ('checked'), an array of findings (each with a code, kind, detail, and subject), timestamps, boolean flags for whether the hold was removed, appeal was granted, policy was fetched, or any marketplace/account was contacted, plus a limitations array explaining what the endpoint could and could not determine from the supplied data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "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
  },
  "holds": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "since": {
      "type": "string",
      "maxLength": 40
     },
     "amount": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "reason": {
      "type": "string",
      "maxLength": 500
     },
     "currency": {
      "type": "string",
      "maxLength": 12
     }
    },
    "additionalProperties": false
   },
   "maxItems": 80
  },
  "metrics": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "unit": {
      "type": "string",
      "maxLength": 40
     },
     "value": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "period": {
      "type": "string",
      "maxLength": 40
     },
     "target": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "direction": {
      "enum": [
       "above",
       "below"
      ],
      "type": "string"
     }
    },
    "additionalProperties": false
   },
   "maxItems": 80
  },
  "notices": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "action": {
      "type": "string",
      "maxLength": 500
     },
     "reason": {
      "type": "string",
      "maxLength": 500
     },
     "deadline": {
      "type": "string",
      "maxLength": 40
     },
     "received": {
      "type": "string",
      "maxLength": 40
     },
     "marketplace": {
      "type": "string",
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "holds": [
   {
    "id": "H-1",
    "since": "2026-11-01",
    "amount": 150,
    "reason": "listing mismatch",
    "currency": "USD",
    "amountSupplied": true,
    "interpretation": "stated"
   },
   {
    "id": "H-2",
    "since": "2026-11-02",
    "amount": 20,
    "reason": "",
    "currency": "EUR",
    "amountSupplied": true,
    "interpretation": "stated"
   }
  ],
  "status": "checked",
  "findings": [
   {
    "code": "hold_unchanged",
    "kind": "observation",
    "detail": "The supplied record says a hold exists. The hold was not removed.",
    "subject": "H-1"
   },
   {
    "code": "reason_missing",
    "kind": "missing",
    "detail": "No hold reason was stated. One was not invented.",
    "subject": "H-2"
   },
   {
    "code": "hold_unchanged",
    "kind": "observation",
    "detail": "The supplied record says a hold exists. The hold was not removed.",
    "subject": "H-2"
   }
  ],
  "checkedAt": "2026-11-04T10:00:00.000Z",
  "holdRemoved": false,
  "limitations": [
   "Notices, metrics, holds, and evidence are copied only from labeled fields supplied by the caller.",
   "A notice is matched only to policy text supplied in the request. No marketplace site is contacted.",
   "A draft does not predict an appeal result or say that a payout is being released.",
   "No seller account is accessed.",
   "A missing field means it was not in the supplied documents."
  ],
  "appealGranted": false,
  "policyFetched": false,
  "accountAccessed": false,
  "marketplaceContacted": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-marketplace-payout-hold-diagnostics-2d780258/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)
