汇率换算（实时）收费

实时汇率兑换 · 最后更新：2026-09-03

🧪 在线调试

GET https://ip258.cn/vip/exchange.php

等待发送请求…

📖 快速调用

📌 支持全球 150+ 币种实时换算，源/目标货币可填中文名（如"人民币"）或三位代码（如 CNY）。示例：?key=您的KEY&from=CNY&to=USD&amount=100 → 返回 100 人民币兑换美元的结果。

🔗 接口信息

接口地址	https://ip258.cn/vip/exchange.php
请求方式	GET / POST，支持跨域
数据格式	JSON（UTF-8）
支持类型	全球150+币种（中文名/三位代码）
计费方式	收费接口，需授权Key调用（联系管理员开通）

💰 套餐介绍

0元购

额度：每天500次限流：3次/秒时长：永久

月套餐

9.9元

额度：6万次/月限流：30次/秒时长：31天

年套餐

120元

额度：90万次/年限流：50次/秒时长：365天

📥 请求参数

参数	必填	类型	说明
`key`	必填	string	会员授权 Key
`from`	必填	string	源货币（中文名或代码，如人民币 / CNY）
`to`	必填	string	目标货币（中文名或代码）
`amount`	必填	number	兑换金额（正数）

📤 返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "from": "CNY",
    "to": "USD",
    "amount": 100,
    "rate": 0.1403,
    "result": 14.03,
    "update_time": "2026-09-03 15:20:00"
  },
  "usage": {
    "today_used": 1,
    "today_remaining": 499,
    "hourly_remaining": "无统计"
  }
}

🗂 data 字段说明

字段	类型	说明
`code`	int	状态码，200 = 成功
`msg`	string	提示信息
`data.from`	string	源货币代码
`data.to`	string	目标货币代码
`data.amount`	number	兑换金额
`data.rate`	number	实时汇率（4 位小数）
`data.result`	number	兑换结果金额（2 位小数）
`data.update_time`	string	更新时间
`usage.today_used`	int	今日已调用次数
`usage.today_remaining`	string	今日剩余次数（不限时显示 "不限"）
`usage.hourly_remaining`	string	小时剩余（暂不统计）

💻 代码示例

curl "https://ip258.cn/vip/exchange.php?key=你的KEY&from=CNY&to=USD&amount=100"

$url = 'https://ip258.cn/vip/exchange.php?key=' . urlencode($key) . '&from=CNY&to=USD&amount=100';
$res = file_get_contents($url);
$data = json_decode($res, true);
echo $data['data']['result']; // 兑换结果

fetch('https://ip258.cn/vip/exchange.php?key=' + key + '&from=CNY&to=USD&amount=100')
  .then(r => r.json())
  .then(d => console.log(d.data));

import requests
r = requests.get('https://ip258.cn/vip/exchange.php', params={
    'key': key, 'from': 'CNY', 'to': 'USD', 'amount': '100'
})
print(r.json()['data'])

🚦 状态码

code	含义	处理
`200`	查询成功	正常解析 data
`400`	参数错误	检查 from/to/amount 是否完整、金额是否为正数
`401`	缺少 / 无效 Key	确认 key 参数正确且已开通
`403`	禁用 / 到期 / 额度用尽	联系管理员续费或解禁
`429`	频率或每日超限	降低调用频率或升级额度
`500`	上游汇率源异常	稍后重试

⏱ 频率限制

🆓 免费接口限流

规则	说明
基础频率	每 Key 每分钟 60 次
瞬时脉冲	每 Key 每秒 3 次（QPS）
每日限量	每天500次

💰 收费接口限流

规则	说明
瞬时脉冲	30次/秒 \| 50次/秒
每日限量	每日最多 N 次（单独设置或系统默认）
总量限制	按充值总量扣减，用尽即停

❓ 常见问题

问题	原因 & 解决
返回 429	超过 QPS / 分钟 / 每日上限，稍后再试或联系管理员扩容
返回 500	上游汇率源暂时异常，稍后重试
支持哪些币种	全球 150 + 币种，中文名（人民币）或代码（CNY）均可