---
name: "getCurrencyList"
mode: "api"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.3.0" }
---

## getCurrencyList

> [VERSION] @tuya-miniapp/cloud-api >= 1.3.0

> 💡 接口依赖云能力，需在[小程序开发者平台](https://platform.tuya.com/miniapp/)开发设置 - 云能力进行授权配置。

### 描述

获取能源能力支持的货币列表。返回系统当前支持的所有货币选项，不含默认货币占位符 DEFAULT，可用于渲染货币选择 UI。

### 参数

无


### 返回值

类型: `Promise<CurrencyItem[]>`

货币列表，每项包含 symbol（货币符号，如 ¥、$）和 code（ISO 4217 货币编码，如 CNY、USD）

##### CurrencyItem

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `symbol` | `string` | 货币符号，如 `¥`、`$` |
| `code` | `string` | 货币编码（ISO 4217），如 `CNY`、`USD` |

### 示例代码

#### 请求示例

```javascript
import { getCurrencyList } from '@tuya-miniapp/cloud-api';

getCurrencyList()
  .then(result => {
    result.forEach(item => {
      console.log(`${item.symbol} (${item.code})`);
    });
  })
  .catch(error => {
    console.error('获取货币列表失败:', error);
  });
```

#### 返回示例

```json
[
  { "symbol": "¥", "code": "CNY" },
  { "symbol": "$", "code": "USD" },
  { "symbol": "€", "code": "EUR" }
]
```


### 常见问题

#### 为什么调用云能力会出现失败的情况？

使用本接口前，请确保设备所属产品已在[涂鸦 IoT 开发平台](https://iot.tuya.com/)开启**电量统计**高级能力。未启用该能力的产品无法采集电量/电费数据，接口将返回空数据或报错。如需使用，请创建带有电量/电费统计功能的产品，并在产品详情中启用相应高级能力。同时，接口依赖云能力，需在[小程序开发者平台](https://platform.tuya.com/miniapp/)`开发设置` - `云能力`进行授权配置。