创建换汇合约 - 福鑫-OpenAPI v2

1，参数【slip】说明：【ref_price】为6.7，用户容忍的【slip】为 0.01。表示用户可以接受成交的价格是6.7上下浮动0.01%，也就是如果当前价格在[6.69933 - 6.70067] 之间可以成交（不传【ref_price】会以市价直接成交，不再校验滑点）；
2，买卖金额精确度说明：JPY只支持到整数，其他币种支持小数点后2位。

请求参数

Header 参数

access_token

string

token

必需

Body 参数application/json

conversion_type

enum<string>

必需

换汇类型(spot:"实时换汇",lock:"预约换汇")

枚举值:

spotlock

buy_currency

string

买入币种

必需

sell_currency

string

卖出币种

必需

buy_amount

number

必需

买入金额(最多两位小数，买入卖出金额只需传一个)

sell_amount

number

必需

卖出金额(最多两位小数，买入卖出金额只需传一个)

slip

number

可选

滑点(小数，默认：0.01，单位：%)

ref_price

number

可选

参考价(获取报价返回的ref_price/ref_price2/bid/offer)

base_currency

string

可选

报价基础货币(与ref_price配对使用)

pay_way

string

必需

支付方式(balance:余额，credit:额度)

c_order_id

string

幂等订单id

必需

>= 8 字符<= 64 字符

value_date

string

可选

履约日(实时不传预约必传，yyyy-MM-dd)

示例

{
  "sell_currency": "USD",
  "buy_currency": "CNH",
  "base_currency": "USD",
  "sell_amount": 100,
  "ref_price": 7.19113,
  "pay_way": "balance",
  "c_order_id": "202308091621FW00008",
  "value_date": "2023-08-10",
  "conversion_type": "lock"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

请求结果

必需

message

string

请求信息

必需

data

object

返回结果

可选

buy_currency

string

买入币种

必需

buy_amount

number

买入金额

必需

sell_currency

string

卖出币种

必需

sell_amount

number

卖出金额

必需

c_order_id

string

幂等订单id

必需

price

number

成交价

必需

base_currency

string

基础货币

必需

price2

number

成交价2

必需

base_currency2

string

基础货币2

必需

status

string

必需

状态：reject("已拒绝") ， waitSettle("待履约")

status_desc

string

状态描述

必需

示例

成功示例参数缺失异常示例

{
  "code": 0,
  "data": {
    "base_currency": "USD",
    "base_currency2": "CNH",
    "buy_currency": "CNH",
    "sell_currency": "USD",
    "status_desc": "待履约",
    "c_order_id": "202308091541FW00002",
    "price": 7.18825,
    "sell_amount": 500,
    "buy_amount": 3594.13,
    "price2": 0.139116,
    "status": "waitSettle"
  },
  "message": "ok"
}