接口能力按货币编号或名称查询历史牌价,可使用查询年月或起止日期范围。记录区分现汇买入、现汇卖出、现钞买入、现钞卖出和中行折算价,并给出发布日期。适合查看同一币种、同一价类在不同日期的变化。中行折算价是独立报价类别,不能直接称为人民币官方中间价,也不能按现汇买卖价的平均数解释。
应用场景历史观察页可展示某币种的现汇卖出价趋势,参考表可把同一天的现汇与现钞报价并列,后台服务也可保存查询区间与返回记录供复核。比较前先统一币种、价类和日期,避免把现钞买入价与现汇卖出价混成一条曲线。图表绘制、排序和缺失标记由调用方完成,接口没有承诺自动补齐每个自然日或提供交易结算结果。
从输入到结果货币编号或名称至少填写一个;按月查询使用yyyyMM,按区间查询使用yyyyMMdd格式的起止日期,查询月份与日期范围不能同时为空。接收结果后检查状态、货币回显和记录日期,再逐条读取所需价类。价格字段是字符串,先识别空值再解析;发布日期不等于精确报价时间。记录日期如需排序可由应用处理,但应保留原记录供对照,不自动补造缺失日期的牌价。
范围与限制当前没有明确两种日期模式同时填写时的优先级、历史可用范围、同日多次报价规则及每一或每百外币的计价单位。确认报价方向和单位前,不应直接把牌价乘以外币金额计算应收应付。历史参考不能代替银行实际成交价,缺失记录也不能解释为当日汇率零或未交易。税务、会计或结算用途还需另行确认适用的日期、价类和业务规则。
常见问题货币编号和名称必须都填吗?至少填写其中一个。若同时填写,应保持指向同一币种,避免条件冲突。
查询某个月怎样填写?使用yyyyMM格式的month;按区间查询则填写yyyyMMdd格式的起止日期。
中行折算价就是官方中间价吗?不能这样解释。当前返回定义明确写中行折算价,应与四类买卖牌价分别处理。
可以直接计算换汇金额吗?先确认报价方向及计价单位,再选择适用的现汇或现钞价类;历史牌价不保证实际交易价格。