福鑫-OpenAPI v2
  1. 接入说明
福鑫-OpenAPI v2
  • 福鑫OpenApi v2版本介绍
  • 接入说明
    • 【公共模块】接入说明
    • 【实时换汇】接入说明
    • 【挂单换汇】接入说明
    • 【预约换汇】接入说明
    • 【webhook回调】接入说明
  • 接口文档
    • 登录
      • 获取token
    • 获取可履约日历
      • 预约换汇日历
      • 合约变更日历
    • 获取参考报价
      • 获取报价
      • 获取报价(bid\offer pingpong视角)
      • 获取合约变更报价
    • 创建换汇
      • 创建换汇合约
      • 创建挂单换汇订单
    • 查询合约
      • 分页查询换汇记录
      • 根据幂等单号查询换汇记录
      • 分页查询挂单记录
    • 修改合约
      • 取消挂单
      • 更改履约日期
      • 撤销
    • 履约
      • 手动发起履约
    • 账户
      • 账户余额查询
      • 实时换汇额度查询
      • 预约换汇额度查询
      • 查询银行卡接口
      • 账户出金
      • 出入金记录查询
    • 回调通知
      • 合约变更事件回调
      • 合约展期事件回调
  1. 接入说明

【实时换汇】接入说明

1 创建实时换汇#

1.1 第一步 获取参考报价#

使用 【获取token】接口得到的【access_token】放入请求头,并加入买卖货币参数,请求【获取报价】接口,得到参考报价【ref_price】。

1.2 第二步 创建实时换汇#

使用【第一步】获取到的参考报价【ref_price】,并加入其他参数,请求【创建换汇合约】接口,创建完成。

1.3 第三步 手动发起履约(可选)#

使用幂等单号【target_c_order_id】参数,请求【手动发起履约】接口,通知福鑫进行履约。
注:
1,余额模式的实时换汇无需【手动发起履约】,福鑫系统会在【创建换汇合约】后立刻进行自动履约;
2,额度模式的实时换汇,您可以选择【手动发起履约】,但发起前请确保您的账户余额充足。在客户没有请求【手动发起履约】的情况下,福鑫系统会在履约日晚上24点自动发起履约。

2 分页查询实时换汇记录#

使用【source_type_list = "spot"】请求【分页查询换汇记录】接口查询实时换汇记录。

3 单笔查询实时换汇记录#

使用幂等单号【target_c_order_id】请求【根据幂等单号查询换汇记录】接口查询换汇记录。

4 履约说明#

4.1 余额模式的实时换汇#

下单时福鑫会校验您的卖出币种账户余额,当余额充足的情况下才能下单成功。当下单成功后,福鑫系统会立刻自动发起履约。无需您手动发起履约了。

4.2 额度模式的实时换汇#

日间手动发起履约
下单时福鑫会校验您的授信额度,当授信额度充足的情况下才能下单成功。当下单成功后,如果您对应的卖出币种余额已经是充足的了,可以选择手动发起履约。手动发起履约时福鑫会判断您的余额是否充足,如果余额充足则发起履约,否则返回余额不足不进行履约操作。
日终自动发起履约
在日间未进行履约的合约,福鑫在晚上24点会自动发起履约。此时不管您的账户余额是否充足,会直接进行履约操作(账户余额可能扣为负的)。

5 请求时序#

image.png

6 合约状态#

reject("已拒绝") , waitSettle("待履约") , settle("已履约")

7 服务时间#

5 X 24h(周一早晨6:00 - 周六早晨5:00)
上一页
【公共模块】接入说明
下一页
【挂单换汇】接入说明
Built with