Currency Conversion and BTC Rates
收藏Currency Conversion and BTC Rates 数据集概述
基本信息
- 数据集名称: Currency Conversion and BTC Rates
- 提供商: Pulse by Arcnull
- 类别: Finance
- API版本: 1.0.0 (current)
- API地址: https://currency-conversion-and-btc-rates.p.rapidapi.com
核心功能
- 提供实时货币兑换和比特币汇率数据。
- 支持295种货币代码（包括USD, EUR, CNY, GBP, BTC等）。
- 比特币汇率每5分钟通过Redis缓存刷新。
- 外汇汇率缓存1小时，确保快速响应。
- 采用3层提供商故障转移机制，当某一数据源失效时自动切换至下一层。
- 内置熔断器与重试机制，提升系统韧性。
- 使用BigDecimal精度，确保金融计算安全。
- 统一的JSON响应格式：
{ success, data }。
端点详情
GET /api/v1/pulse/currencies/conversions
描述: 在任意两种货币之间进行兑换。
必需参数:
- from (string): 源货币代码（例如 USD, EUR, BTC）。
- to (string): 目标货币代码（例如 CNY, GBP）。
- amount (number): 需兑换的金额（必须大于0）。
响应示例:
json
{
"success": true,
"data": {
"date": "2026-04-14",
"from": "USD",
"to": "CNY",
"originalAmount": 100.0,
"convertedAmount": 724.52
}
}
GET /api/v1/pulse/btc-rates
描述: 获取比特币对所有支持货币的汇率。 响应示例: json { "success": true, "data": { "date": "2026-04-14", "rates": { "USD": 84521.32, "EUR": 78234.15, "CNY": 613847.23 } } }
GET /api/v1/pulse/currencies/supported
描述: 返回所有295种支持的货币代码列表。 响应示例: json { "success": true, "data": ["AED", "AFN", "ALL", "AMD", "USD", "EUR", "CNY", "..."] }
GET /api/v1/pulse/info
描述: 获取模块状态和元数据。 响应示例: json { "success": true, "data": { "module": "pulse", "version": "1.0.0", "status": "operational" } }
认证与请求
- 所有请求均需在请求头中提供RapidAPI密钥：
X-RapidAPI-Key。 - 请求头中必须包含：
X-RapidAPI-Host: currency-conversion-and-btc-rates.p.rapidapi.com。
服务等级与性能
- 流行度: 9.3
- 服务等级: 100%
- 延迟: 790ms
- 测试率: 14%
订阅计划与速率限制
| 计划 | 价格/月 | 请求/分钟 | 请求/天 |
|---|---|---|---|
| Basic | $0.00 | 10 | 500 |
| Pro | $4.99 | 50 | 5,000 |
| Ultra | $19.99 | 200 | 20,000 |
| Mega | $49.99 | 500 | 50,000 |
系统韧性设计
- 熔断器: 50%故障阈值，30秒恢复窗口。
- 重试逻辑: 3次尝试，采用指数退避策略（1秒 → 2秒 → 4秒）。
- 舱壁隔离: 最大并发调用数为10。
错误代码
| 代码 | 错误 | 描述 |
|---|---|---|
| 401 | MISSING_API_KEY |
未提供API密钥 |
| 403 | INVALID_API_KEY |
密钥无效或已过期 |
| 400 | VALIDATION_ERROR |
参数缺失或无效 |
| 503 | PULSE_FETCH_FAILED |
所有汇率提供商暂时不可用 |
错误响应格式: json { "success": false, "message": "Missing required parameter: from", "errorCode": "VALIDATION_ERROR" }
支持的货币示例
支持295种货币，包括：USD EUR GBP CNY JPY CAD AUD CHF INR KES BRL MXN SGD HKD NOK SEK DKK NZD ZAR AED SAR QAR KWD BHD OMR JOD EGP MAD NGN GHS TZS UGX RWF ETB XOF XAF BTC 以及另外258种货币。完整列表可通过调用 /api/v1/pulse/currencies/supported 获取。
