# China Bank Offers Facts API

> Official source-linked China bank card offer documents for agent callers through one bank_code-based query. No rankings or recommendations.

Bank facts are published only after source binding, semantic review and freshness checks. This independent public-facts aggregator is not affiliated with the banks. Agents should inspect coverage and provenance on every response.

## Machine contracts

- [OpenAPI](https://agent-offers-api-replitzip.replit.app/openapi.json): Authoritative HTTP request and response contract.
- [Agent skill](https://agent-offers-api-replitzip.replit.app/SKILL.md): Concise bilingual instructions for discovery, filters, payment approval and source-linked output.
- [Remote MCP](https://agent-offers-api-replitzip.replit.app/mcp): Streamable HTTP endpoint with free list_supported_banks and paid get_bank_offers.
- [API catalog](https://agent-offers-api-replitzip.replit.app/.well-known/api-catalog): RFC 9727 Linkset discovery document.
- [Supported banks](https://agent-offers-api-replitzip.replit.app/v1/supported-banks): Free capability list, freshness and query availability.
- [Coverage](https://agent-offers-api-replitzip.replit.app/v1/coverage): Legacy aggregate coverage view.
- [Synthetic sample](https://agent-offers-api-replitzip.replit.app/v1/sample): Schema-only example, never a live offer.

## Copy-ready call

Natural-language prompt:

`帮我查询工商银行目前有效或状态未知的银行卡优惠。先确认该银行受支持，再调用统一查询工具；返回时保留官方原文和官方链接。`

Unified HTTP request body for an x402-capable client:

`{"bank_code":"ICBC","activity_status":["active","unknown"]}`

Free preflight: `GET https://agent-offers-api-replitzip.replit.app/v1/supported-banks`. Paid HTTP endpoint: `POST https://agent-offers-api-replitzip.replit.app/v1/offers/search`. Remote MCP endpoint: `https://agent-offers-api-replitzip.replit.app/mcp`.
MPP mainnet endpoint: `POST https://agent-offers-api-replitzip.replit.app/v1/mpp/offers/search`. Its `WWW-Authenticate: Payment` challenge, settlement receipt, and business response are distinct from the Base/x402 rail.

Send exactly one JSON-RPC message per MCP request; batch requests are not supported. One paid `get_bank_offers` call selects one bank and produces one bounded delivery.

## Policies

- [Pricing](https://agent-offers-api-replitzip.replit.app/pricing): Current x402 price, network, asset and facilitator.
- [Terms](https://agent-offers-api-replitzip.replit.app/terms): Facts-only usage boundary.
- [Data provenance](https://agent-offers-api-replitzip.replit.app/data-provenance): Source, uncertainty, and publication rules.