# Chinamoney — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time and historical China interbank market data including FX rates, SHIBOR and LPR benchmark rates, RMB exchange indices, and CNY central parity rates. Monitor spot FX quotes, daily bulletins, and monthly average rates to track Chinese currency movements and money market trends.

**Category:** Finance & Markets | **Website:** [chinamoney.com.cn/](https://chinamoney.com.cn/) | **Docs:** [parse.bot/marketplace/21fcaaf5-21fb-4fb7-ae38-d25bc93392b4/chinamoney-com-cn-api](https://parse.bot/marketplace/21fcaaf5-21fb-4fb7-ae38-d25bc93392b4/chinamoney-com-cn-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cny_central_parity_rate

Fetch the latest CNY central parity rates published by CFETS. Returns rates for all major currency pairs against CNY as of the most recent trading day. Each record includes the pair name, rate, and basis point change from the previous day.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_cny_central_parity_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cny_central_parity_rate_history

Fetch historical CNY central parity rates with pagination. Returns daily rate values for one or more currency pairs within a date range. Each record contains a date and an array of rate values corresponding to the selected currency pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency pair (e.g. 'USD/CNY', 'EUR/CNY'). Omit or leave empty for all pairs. |
| `end_date` | string | No | End date in YYYY-MM-DD format. |
| `page_num` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of results per page. |
| `start_date` | string | No | Start date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_cny_central_parity_rate_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","end_date":"<string>","page_num":"<integer>","page_size":"<integer>","start_date":"<string>"}'
```

### get_cny_monthly_average_rate

Fetch the monthly average central parity rates for all currency pairs. Returns the mean rate for the most recently completed month and the basis point difference from the prior month.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_cny_monthly_average_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cny_reference_rate

Fetch the latest CNY reference exchange rates. Returns rates for all reference currency pairs in CNY/XXX format. Updated monthly.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_cny_reference_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cny_reference_rate_history

Fetch historical CNY reference rates. Returns monthly average rates for each currency pair within a date range. Currency pairs use CNY/XXX format.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency pair in CNY/XXX format (e.g. 'CNY/AOA', 'CNY/INR'). Use 'ALL' or omit for all currencies. |
| `end_date` | string | No | End date in YYYY-MM-DD format. |
| `start_date` | string | No | Start date in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_cny_reference_rate_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","end_date":"<string>","start_date":"<string>"}'
```

### get_daily_bulletin

Fetch the daily market bulletins list from the interbank market. Returns links to bulletins covering lending, repo, bond trading, and SHIBOR.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_daily_bulletin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_lpr_rates

Fetch the Loan Prime Rate (LPR) for the 1-year and 5-year tenors. Updated monthly on the 20th.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_lpr_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_rmb_exchange_rate_index

Fetch the RMB exchange rate index values for the CFETS, BIS, and SDR currency baskets. Returns the latest index value and basis point change for each basket.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_rmb_exchange_rate_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_rmb_fx_spot_quotes

Fetch the latest RMB/FX spot quotes for all traded currency pairs. Returns bid, ask, and mid prices from the interbank market.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_rmb_fx_spot_quotes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_shibor_rates

Fetch the Shanghai Interbank Offered Rate (SHIBOR) for all tenors: O/N, 1W, 2W, 1M, 3M, 6M, 9M, 1Y. Returns the current rate and change in basis points for each tenor.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chinamoney-com-cn-api-21fcaaf5/get_shibor_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```