rates.readGET /api/v2/ratesGET /api/v2/convert
REST API v2
稳定、可追踪、更节省流量
currencies.readGET /api/v2/currencies
支持搜索与游标分页。
history.readGET /api/v2/history
单次最多十年。
data.readGET /api/v2/datasets
筛选、游标式数据读取。
请求示例自动返回 ETag 与请求编号
curl "https://hl.feihaiwangluo.com/api/v2/convert?amount=100&from=USD&to=CNY" \
-H "X-API-Key: hvt_live_你的密钥"请在“管理后台 → 开放 API”按最小权限创建密钥，并保存在服务端密钥环境中。现有 API v1 接入继续可用。
OFFICIAL SDK
PHP 与 JavaScript 开箱接入
HuilvtongClient
零第三方依赖，封装全部 API v2 方法。
下载 PHP SDK ↓HuilvtongClient
ES Module 客户端，支持游标与 ETag。
下载 JavaScript SDK ↓PHP不要在浏览器代码中暴露密钥
$client = new Huilvtong\HuilvtongClient(
'https://hl.feihaiwangluo.com',
getenv('HUILVTONG_API_KEY')
);
$result = $client->convert(100, 'USD', 'CNY');SIGNED WEBHOOKS
无需轮询，主动接收事件
新汇率批次已经可用。
数据源失败，可能已启用缓存回退。
从后台验证签名和投递链路。
投递使用 HMAC-SHA256 签名，固定到公网 HTTPS 地址，并按指数退避重试。接收端点在管理后台配置。
KEYLESS EMBED WIDGETS
无需 API 密钥