NewConnect Claude, Cursor, ChatGPT, and other AI agents to API Ninjas via our MCP server →
Currency Conversion API

Chinese Yuan (CNY) Currency API

The Chinese Yuan (Renminbi) is the currency of the world's second-largest economy and is increasingly used in international trade and reserve holdings. Managed by the People's Bank of China, the CNY operates under a managed float system with daily reference rates. CNY exchange rates are influenced by PBOC policy, US-China trade relations, capital flows, and Chinese economic growth data.

The Chinese Yuan Currency API allows you to:

  • Convert CNY (Chinese Yuan) to any of 170+ supported currencies
  • Get real-time CNY exchange rates
  • Access CNY conversion rates via simple REST API
  • Free tier available for CNY currency pairs
(4.4)

From 5,079 users

2,800+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
182ms200ms231ms439ms1030ms

Didn't find what you were looking for? Suggest an improvement

/v1/convertcurrency GET

https://api.api-ninjas.com/v1/convertcurrency

Parameters

  • have  required

    Currency you currently hold. For example, CNY.

  • want  required

    Currency you want to convert to. For example, USD.

  • amount  required

    Amount of currency to convert.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • old_amount

    The original amount provided in the request.

  • old_currency

    The original currency code (e.g. CNY).

  • new_currency

    The target currency code (e.g. USD).

  • new_amount

    The converted amount in the target currency.

  • timestamp

    Unix timestamp (in seconds) indicating the time at which the exchange rate used for the conversion was applied.

Related CNY Currency Pairs

PairFromTo
USD/CNYUnited States DollarChinese Yuan

Sample Request Live Demo!

have
want
amount

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/convertcurrency?have=CNY&want=USD&amount=1000

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/convertcurrency?have=CNY&want=USD&amount=1000" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed above, you can still make API calls by using any HTTP request library and following the documentation above.