1. 实时换汇
福鑫-OpenAPI
  • 公共
    • 【公共】模块接入说明
    • 获取token
      GET
  • 实时换汇
    • 【实时换汇】模块接入说明
    • 获取报价
      POST
    • 获取报价(bid\offer 客户视角)
      POST
    • 批量获取报价(bid\offer 客户视角)
      POST
    • 获取报价(bid\offer 机构视角)
      POST
    • 创建实时换汇合约
      POST
    • 手动发起交割
      POST
    • 查询换汇记录
      POST
    • 根据幂等单号查询换汇记录
      POST
  • 挂单换汇
    • 【挂单换汇】模块接入说明
    • 获取报价(同实时换汇获取报价)
      POST
    • 获取报价(bid\offer 客户视角)(同实时换汇)
      POST
    • 创建挂单换汇合约
      POST
    • 修改挂单合约
      POST
    • 取消挂单合约
      POST
    • 查询挂单记录
      POST
    • 根据幂等单号查询换汇记录(请参考实时换汇-根据幂等单号查询换汇记录)
      POST
  • 预约换汇
    • 【预约换汇】模块接入说明
    • 获取交易日历
      POST
    • 获取报价
      POST
    • 获取报价(bid\offer 客户视角)
      POST
    • 获取报价(bid\offer 机构视角)
      POST
    • 创建预约换汇合约
      POST
    • 手动发起交割(请参考实时换汇-手动发起交割)
      POST
    • 查询换汇记录(请参考实时换汇-查询换汇记录)
      POST
    • 获取展期日历
      POST
    • 获取展期报价
      POST
    • 展期
      POST
    • 展期v2
      POST
    • 撤销
      POST
    • 根据幂等单号查询换汇记录(请参考实时换汇-根据幂等单号查询换汇记录)
      POST
  • 账户
    • 账户余额查询
    • 实时换汇额度查询
    • 预约换汇额度查询
    • 查询银行卡接口
    • 账户出金
    • 出入金记录查询
  • 数据模型
    • 未命名数据模型
  1. 实时换汇

【实时换汇】模块接入说明

创建实时换汇步骤#

第一步#

使用【公共】-【获取token】接口得到的【access_token】放入请求头,并加入买卖货币参数,请求接口文档【实时换汇】-【获取报价】接口,得到参考报价【ref_price】

第二步#

使用获取到的【access_token】放入请求头,【第一步】获取到的参考报价【ref_price】,并加入其他参数,请求接口文档【实时换汇】-【创建换汇合约】接口,创建换汇合约,得到交易id【transaction_id】

第三步(可选)#

使用获取到的【access_token】放入请求头,并加入【第二步】获取到的交易id【transaction_id】参数,请求接口文档【实时换汇】-【手动发起交割】接口,通知福鑫进行交割。
注:
1,余额模式的实时换汇无需【手动发起交割】,系统会在【创建换汇合约】后立刻自动进行交割。
2,授信模式的实时换汇,您可以【手动发起交割】,但发起前请确保您的账户余额充足。在客户没有发起【手动发起交割】的情况下,福鑫系统会在交割日24点自动发起交割。

查询换汇记录#

使用获取到的【access_token】放入请求头,并传入【source_type_list = ["spot"]】请求接口文档【查询换汇记录】查询实时换汇记录。

交割说明#

余额模式的实时换汇#

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

授信模式的实时换汇#

日间手动发起交割#

下单时福鑫会校验您的授信额度,当授信额度充足的情况下才能下单成功。当下单成功后,如果您对应的卖出币种余额已经是充足的了,可以选择手动发起交割。手动发起交割时福鑫会判断您的余额是否充足,如果余额充足则发起交割,否则返回余额不足不进行交割操作。

日终自动发起交割#

在日间未进行交割的合约,福鑫在晚上12点会自动发起交割。此时不管您的账户余额是否充足,会直接进行交割操作(账户可能转为负的)。

请求时序#

image.png

合约状态#

reject("已拒绝") , waitSettle("待交割") , settle("已交割")
修改于 2023-07-20 08:59:21
上一页
获取token
下一页
获取报价
Built with