Skip to content
IN PROGRESS

This site is under active development. The sandbox is coming soon.

This is an independent, unofficial personal learning project. It does not represent any bank, financial institution, or regulator.

API overview

All APIs follow the same request and response conventions.

https://api.openbanking.org.cn/v1
Header Required Description
Authorization Yes Bearer <access_token>
Content-Type Yes application/json (except form endpoints)
X-Request-Id No Caller-generated request identifier for tracing
Idempotency-Key Required for payments Idempotency key; UUID v4 recommended

List endpoints use page and page_size; page_size is capped at 100.

{
"data": [],
"pagination": { "page": 1, "page_size": 20, "total": 0 }
}

Non-2xx responses return a structured error:

{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Account not found",
"request_id": "req_01J9Z3K4"
}
}

The version is part of the path (/v1). Incompatible changes are released as a new version, and older versions are supported for at least 12 months.