# China Bank Offers Facts

> China Bank Offers Facts is a paid API for AI agents from agent-offers-api-replitzip.replit.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Searches and returns official bank card offer documents from major Chinese banks, including full offer text, source URLs, hashes, status labels, tags, and enrollment requirements.

## Facts

- Endpoint: POST https://agent-offers-api-replitzip.replit.app/v1/offers/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-bank-offers-facts-d643e622
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dk3KgkWGIWE3gBb6a4Cbw

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 china-bank-offers-facts-d643e622 -d '<json body>'
```

Example prompt: Pull all active and upcoming credit card offer documents for ICBC from China Bank Offers Facts — I need the full offer text, official source URLs, and enrollment requirements.

## When to prefer this

Use this endpoint when you need official, source-linked bank card offer documents from specific major Chinese banks (ABC, BOCOM, CGB, CMBC, ICBC, PSBC, SPDB) and require verifiable data including source URLs, content hashes, and enrollment requirements. Prefer this over general web searches when authoritative, structured, and hash-verified offer data is required. Choose this when filtering by offer status (active, expired, upcoming) or when programmatically processing Chinese bank promotional documents at scale.

## Known failure modes

- Invalid or unsupported bank_code returns a validation error
- Empty activity_status array rejected (minimum 1 item required)
- No matching offers found returns an empty result set
- Malformed tag patterns (not matching ^[a-z][a-z0-9_]*:[a-z0-9][a-z0-9_-]*$) cause validation failure
- Payment failure (x402) prevents call from completing
- Service unavailability returns a 5xx error

## How this service works

面向 Agent 的中国银行卡优惠官方原文聚合服务。Structured, source-linked China bank card offer facts for agents.

## Output

Returns a collection of official bank card offer documents for the selected Chinese bank, each containing cleaned full activity text, official source URLs, cryptographic hashes for verification, status labels (active/expired/upcoming/unknown), categorization tags, and enrollment requirements. No recommendations or rankings are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bank_code": {
   "enum": [
    "ABC",
    "BOCD",
    "BOCOM",
    "BOS",
    "CCB",
    "CEB",
    "CGB",
    "CIB",
    "CITIC",
    "CMB",
    "CMBC",
    "CZB",
    "GZCB",
    "HXB",
    "ICBC",
    "NBCB",
    "PAB",
    "PSBC",
    "SPDB"
   ],
   "type": "string",
   "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$"
  },
  "activity_status": {
   "type": "array",
   "items": {
    "enum": [
     "active",
     "expired",
     "upcoming",
     "unknown",
     "mixed",
     "all"
    ],
    "type": "string"
   },
   "default": [
    "active",
    "unknown"
   ],
   "maxItems": 6,
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bank": {
   "bank_code": "ABC",
   "bank_name_en": "ABC",
   "bank_name_zh": "ABC"
  },
  "as_of": "2026-07-21T08:00:00+08:00",
  "count": 1,
  "offers": [
   {
    "title": "ABC official offer",
    "fetched_at": "2026-07-21T08:00:00+08:00",
    "document_id": "00000000-0000-4000-8000-000000000001",
    "content_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
    "official_url": "https://example.invalid/official-offer",
    "official_text": "Complete cleaned official activity text.",
    "activity_status": "active",
    "activity_windows": [
     {
      "end_date": "2026-07-31",
      "start_date": "2026-07-01",
      "evidence_quote": "2026-07-01 through 2026-07-31"
     }
    ],
    "content_modality": "text",
    "source_resources": [
     {
      "url": "https://example.invalid/official-offer",
      "kind": "link"
     }
    ],
    "text_completeness": "complete",
    "source_document_url": "https://example.invalid/official-offer"
   }
  ],
  "filters": {
   "activity_status": [
    "active",
    "unknown"
   ]
  },
  "truncated": false,
  "data_as_of": "2026-07-21T08:00:00+08:00",
  "request_id": "req_schema_example"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-bank-offers-facts-d643e622/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-offers-api-replitzip.replit.app](https://www.zero.xyz/host/agent-offers-api-replitzip.replit.app/llms.txt)