# Revenue Ghost Evidence Analyzer

> Revenue Ghost Evidence Analyzer is a paid API for AI agents from bounty-engineer-x402-prod.onrender.com, paid per call via x402, $49.9/call, status unknown (last checked 2026-10-12).

Detects revenue gaps, billing discrepancies, and unsettled amounts by reconciling usage, invoice, and payment records for a given billing period.

## Facts

- Endpoint: POST https://bounty-engineer-x402-prod.onrender.com/v1/revenue-ghost-evidence?utm_source=zero.xyz
- Price: $49.9/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/revenue-ghost-evidence-analyzer-6e7ef5ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0AANGsCukVglcBUBTlaaD

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 revenue-ghost-evidence-analyzer-6e7ef5ca -d '<json body>'
```

Example prompt: Can you check my September 2026 billing data for revenue ghosts — I have usage records showing 'api_calls' for machine-operator-1 with usage_id 'usage-101' at $1600 expected, one invoice for $100, and a payment of $80 — tell me what's uninvoiced, underbilled, or unsettled.

## When to prefer this

Choose this endpoint when you need to systematically reconcile usage metering records against invoices and payments to surface revenue gaps, underbilling, or unsettled amounts for a specific billing period. It is especially useful for autonomous agent billing pipelines where usage is metered by subject and meter type. Prefer this over manual spreadsheet reconciliation or generic accounting APIs when you need structured case-by-case discrepancy output with recommended next steps and duplicate detection.

## Known failure modes

- Missing required fields in usage, invoice, or payment objects causes validation failure
- Providing more than 200 items in any array exceeds the maxItems limit
- Misformatted period string (not YYYY-MM) may cause parsing errors
- Unlinked IDs (invoice referencing nonexistent usage_id) result in unmatched record flags
- No external authentication of data — results are advisory only, not legally verified
- High price per call ($49.9 USDC) means misconfigured retries can be expensive

## How this service works

Machine-buyable infrastructure for autonomous agents: API cost routing, margin optimization, funding-rate data, webpage extraction, result verification, spend controls, retry planning, state, tender search and GitHub bounty intelligence.

## Output

Returns a JSON object with a list of discrepancy cases per meter/subject, each showing expected vs invoiced vs net paid amounts, uninvoiced and underbilled candidate figures, overbilling and overpayment exposure, duplicate detection results for usage/invoices/payments, unmatched invoice and payment IDs, a SHA-256 hash of the source data, recommended reconciliation steps, and a total revenue gap candidates sum — all clearly marked as caller-supplied-data analysis with no funds moved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "usage": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "subject",
     "meter",
     "units",
     "unit_price_usd"
    ]
   },
   "maxItems": 200,
   "minItems": 1
  },
  "period": {
   "type": "string",
   "description": "YYYY-MM"
  },
  "invoices": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "usage_id",
     "billed_usd"
    ]
   },
   "maxItems": 200
  },
  "payments": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "invoice_id",
     "amount_usd",
     "status"
    ]
   },
   "maxItems": 200
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "mode": "revenue_ghost_evidence",
  "cases": [
   {
    "meter": "api_calls",
    "subject": "machine-operator-1",
    "usage_id": "usage-101",
    "payment_ids": [
     "payment-101"
    ],
    "expected_usd": "1600.00",
    "invoiced_usd": "100.00",
    "net_paid_usd": "80.00",
    "invoice_line_ids": [
     "line-101"
    ],
    "candidate_unsettled_usd": "20.00",
    "candidate_uninvoiced_usd": "0.00",
    "possible_overbilling_usd": "0.00",
    "possible_overpayment_usd": "0.00",
    "candidate_underbilled_usd": "1500.00",
    "fractional_cent_truncated": false
   }
  ],
  "period": "2026-09",
  "case_count": 1,
  "duplicates": {
   "usage": [],
   "invoices": [],
   "payments": []
  },
  "limitations": [
   "Caller-supplied snapshots only; no provider/bank/on-chain authentication.",
   "Not evidence of a legally recoverable debt or actual third-party demand.",
   "No funds moved, refunds issued, claims submitted or buyer wallets signed."
  ],
  "usage_count": 1,
  "invoice_count": 1,
  "payment_count": 1,
  "source_sha256": "5cc360f183aaeb58ee37bbfd934cdb90a8de0d00c5523c495649b40d3fa62a46",
  "unmatched_invoices": [],
  "unmatched_payments": [],
  "recommended_next_steps": [
   "Independently verify original immutable usage and paid ledger exports.",
   "Check refunds, net terms, partial payments, taxes, credits and legitimate multi-line charges.",
   "Reconcile each discrepancy with the billing provider before any collection or correction."
  ],
  "revenue_gap_candidates_usd": "1520.00",
  "possible_billing_exposure_usd": "0.00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/revenue-ghost-evidence-analyzer-6e7ef5ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bounty-engineer-x402-prod.onrender.com](https://www.zero.xyz/host/bounty-engineer-x402-prod.onrender.com/llms.txt)