> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xapichina.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CNY and EUR prices

> Understand source prices, euro conversion, and inward budget rounding.

## Response currencies

`price_cny` is the source listing price in yuan. A value of `188000` means ¥188,000, not ¥1.88 billion. When a rate is available, `price_eur` is the converted amount rounded to two decimals.

Both fields are returned independently of the search's `currency` parameter. Missing source prices or exchange rates produce nullable values rather than an invented price.

## CNY filters

```bash theme={"system"}
curl --fail-with-body \
  "https://api.xapichina.com/v1/search?brand=BMW&currency=cny&price_min=100000&price_max=200000" \
  -H "X-API-Key: $XAPICHINA_API_KEY"
```

CNY bounds must be nonnegative multiples of 10,000. A bound of `105000` is rejected with `422`; choose a supported step rather than expecting exact-yuan source filtering.

## EUR filters

```bash theme={"system"}
curl --fail-with-body \
  "https://api.xapichina.com/v1/search?brand=BMW&currency=eur&price_min=15000&price_max=30000" \
  -H "X-API-Key: $XAPICHINA_API_KEY"
```

The rate is expressed as **CNY per EUR**. The API converts the minimum upward and the maximum downward to 10,000-CNY steps, keeping the source filter inside your requested budget.

For an illustrative rate of 7.8 CNY per EUR:

| Requested bound | Converted amount | Source filter |
| - | - | - |
| Minimum €15,000 | ¥117,000 | Minimum ¥120,000 |
| Maximum €30,000 | ¥234,000 | Maximum ¥230,000 |

This is a rounding example, not the current exchange rate. Listings near the original EUR boundaries can be excluded. A narrow budget with no supported CNY step returns an empty result.

## Missing or older rates

The backend refreshes exchange rates and can retain its last known good quote during a provider outage. Displayed EUR values can therefore use an older rate. When no rate is available, CNY requests can still return source prices with `price_eur: null`; EUR budget filtering returns `503` with a retry hint.

EUR prices are reference conversions rather than final purchase, shipping, tax, or currency-exchange quotes. Preserve the original CNY amount and confirm important prices against the source listing.

## Counting within a budget

`/v1/search/count` uses the same currency interpretation and rounding rules as search. It returns `count` and consumes a separate data request.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.