人民币牌价数据

获取人民币外汇牌价历史数据,含现汇与现钞的买入卖出价。适合研究人民币汇率走势,也可用于结售汇时点的历史对比。

说明:套餐用户请把 apiKey 替换为 apiToken 调用接口。

接口地址: api.cxdy.vip/api/pjsj

返回格式: JSON

请求方式: GET

请求示例: https://api.cxdy.vip/api/pjsj?apiKey=你的apiKey&symbol=美元&start_date=1979-09-01&end_date=2222-01-01

请求参数说明:

🔑 鉴权凭证(二选一,以查询参数方式随请求传入):
apiKey — 单接口购买用户的密钥,购买后在会员中心获取;
apiToken — 套餐用户的访问令牌,在会员中心生成。
名称 必填 类型 说明
symbol 是 string symbol=美元; 美元, 英镑, 欧元, 澳门元, 泰国铢, 菲律宾比索, 港币, 瑞士法郎, 新加坡元, 瑞典克朗, 丹麦克朗, 挪威克朗, 日元, 加拿大元, 澳大利亚元, 新西兰元, 韩国元
start_date 是 string start_date=20230304; 开始日期和结束日期之间的间隔要超过 6 个月
end_date 是 string end_date=20231110; 开始日期和结束日期之间的间隔要超过 6 个月

返回参数说明:

名称 类型 说明
日期 string 数据日期
中行汇买价 float 中行汇买价
中行钞买价 float 中行钞买价
中行钞卖价/汇卖价 float 中行钞卖价/汇卖价
央行中间价 float 央行中间价

返回示例:

[{
		"日期": "2023-11-08T00:00:00.000",
		"中行汇买价": 726.73,
		"中行钞买价": 726.57,
		"中行钞卖价/汇卖价": 729.63,
		"央行中间价": 717.73
	},
	{
		"日期": "2023-11-09T00:00:00.000",
		"中行汇买价": 727.28,
		"中行钞买价": 727.12,
		"中行钞卖价/汇卖价": 730.18,
		"央行中间价": 717.72
	},
	{
		"日期": "2023-11-10T00:00:00.000",
		"中行汇买价": 727.98,
		"中行钞买价": 727.82,
		"中行钞卖价/汇卖价": 730.88,
		"央行中间价": 717.71
	}
]

错误码格式说明:

名称 类型 说明
200 int 请求成功
203 int 请求过于频繁(触发限流),请稍后再试
400 int 请求参数错误:缺少必填参数或参数格式不正确
401 int 鉴权失败:apiKey 无效、API Token 无效或已过期、付费接口未传有效凭证
403 int 拒绝访问:接口已到期请续费,或账号/IP 因违规调用被临时封禁
404 int 接口不存在或已下架;或来源 IP 不在该接口的 IP 白名单内
429 int 调用超限:免费/套餐/单接口用户的当日调用次数已达上限
500 int 服务器错误:上游数据源暂时不可用,请稍后重试

代码示例:

curl 请求示例(apiKey,单接口购买用户):
curl "https://api.cxdy.vip/api/pjsj?apiKey=你的apiKey&symbol=美元&start_date=1979-09-01&end_date=2222-01-01"

curl 请求示例(apiToken,套餐用户):
curl "https://api.cxdy.vip/api/pjsj?apiToken=你的apiToken&symbol=美元&start_date=1979-09-01&end_date=2222-01-01"

PHP 请求示例:
<?php
// 套餐用户请将 apiKey=你的apiKey 换成 apiToken=你的apiToken
$ch = curl_init('https://api.cxdy.vip/api/pjsj?apiKey=你的apiKey&symbol=美元&start_date=1979-09-01&end_date=2222-01-01');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python 请求示例:
import requests

url = "https://api.cxdy.vip/api/pjsj"
params = {"apiKey": "你的apiKey", "symbol": "美元", "start_date": "1979-09-01", "end_date": "2222-01-01"} # 套餐用户将 apiKey 换成 apiToken
response = requests.get(url, params=params)
print(response.json())

请求参数设置:

参数名称 参数值
[{
		"日期": "2023-11-08T00:00:00.000",
		"中行汇买价": 726.73,
		"中行钞买价": 726.57,
		"中行钞卖价/汇卖价": 729.63,
		"央行中间价": 717.73
	},
	{
		"日期": "2023-11-09T00:00:00.000",
		"中行汇买价": 727.28,
		"中行钞买价": 727.12,
		"中行钞卖价/汇卖价": 730.18,
		"央行中间价": 717.72
	},
	{
		"日期": "2023-11-10T00:00:00.000",
		"中行汇买价": 727.98,
		"中行钞买价": 727.82,
		"中行钞卖价/汇卖价": 730.88,
		"央行中间价": 717.71
	}
]