实时汇率查询换算API接口文档 GET / POST 金融数据

实时汇率查询换算API提供全球主要货币之间的实时汇率查询和金额换算服务。数据每分钟更新一次。【注意：汇率行情仅供参考，旨在提供市场动态和信息，不构成任何形式的投资建议。】

请求 GET / POST返回 application/json0.1 积分 / 次上线 2026-09-24 14:57:41

实时汇率查询换算API提供全球主要货币之间的实时汇率查询和金额换算服务。数据每分钟更新一次。【注意：汇率行情仅供参考，旨在提供市场动态和信息，不构成任何形式的投资建议。】

0.1 积分 / 次调用次数: 10正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=exchange
方法
GET / POST
分类
金融数据
计费
0.1 积分 / 次
KEY
KEY 必填
调用
10
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

实时汇率查询换算接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=exchange
请求方式：
GET / POST
返回格式：
application/json

调用统计

10总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=exchange

apikey=你的API密钥&from=请填写from&to=请填写to&money=请填写money

GET 参数放在查询字符串中。参数值请替换为实际有效值。

实时汇率查询换算请求参数

参数名类型必填说明示例
fromstring是源货币代码（大写），如：CNY、USD、EUR
tostring是目标货币代码（大写），如：USD、JPY、GBP
moneystring否需要换算的金额，默认为 1。必须大于 0
返回示例
{"success":true,"data":{"from":"CNY","from_name":"人民币","to":"USD","to_name":"美元","exchange":"0.147796","money":"0.147796","updatetime":"2026-07-29 18:28:02"},"input":{"from":"CNY","to":"USD","money":"1"},"generated_at":"2026-07-29 19:12:18"}

详细文档

实时汇率查询换算 API 接口文档

接口描述

实时汇率查询换算API提供全球主要货币之间的实时汇率查询和金额换算服务。数据每分钟更新一次。【注意：汇率行情仅供参考，旨在提供市场动态和信息，不构成任何形式的投资建议。】

功能特性

  • 实时汇率查询换算API提供全球主要货币之间的实时汇率查询和金额换算服务。数据每分钟更新一次。【注意：汇率行情仅供参考，旨…
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=exchange

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

  • URL 参数：key=SK-你的密钥
  • 或请求头：X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
from string 是 源货币代码（大写），如：CNY、USD、EUR
to string 是 目标货币代码（大写），如：USD、JPY、GBP
money string 否 需要换算的金额，默认为 1。必须大于 0

请求参数 (JSON格式)

[
  {"name": "from", "type": "string", "required": true, "description": "源货币代码（大写），如：CNY、USD、EUR"},
  {"name": "to", "type": "string", "required": true, "description": "目标货币代码（大写），如：USD、JPY、GBP"},
  {"name": "money", "type": "string", "required": false, "description": "需要换算的金额，默认为 1。必须大于 0"}
]

响应格式

JSON 格式响应

成功返回示例：

{"success":true,"data":{"from":"CNY","from_name":"人民币","to":"USD","to_name":"美元","exchange":"0.147796","money":"0.147796","updatetime":"2026-07-29 18:28:02"},"input":{"from":"CNY","to":"USD","money":"1"},"generated_at":"2026-07-29 19:12:18"}

失败返回示例：

HTTP/1.1 400 Bad Request

{
  "success": false,
  "error": "missing_currency",
  "message": "请提供源货币（from）和目标货币（to）参数"
}

返回参数说明

参数名 类型 说明
success boolean 请求是否成功
data.from string 源货币代码
data.from_name string 源货币名称
data.to string 目标货币代码
data.to_name string 目标货币名称
data.exchange string 当前汇率（1 源货币 = X 目标货币）
data.updatetime string 汇率更新时间
data.money string 换算后的金额
input object 请求时的输入参数回显
generated_at string 接口响应时间

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=exchange?key=SK-你的密钥&from=CNY&to=USD&money=1"

错误响应

上游业务级错误：

code msg 描述
400 missing_currency 缺少 from 或 to 参数
400 invalid_money 金额参数无效
401 invalid_api_key API密钥无效或未提供
500 config_error 服务配置异常
500 api_request_failed 第三方接口请求异常
500 api_parse_failed 第三方接口响应解析失败
502 query_failed 汇率查询失败

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
  • 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
  • 请合理控制调用频率，避免高频恶意调用触发风控
  • 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24