分页查询换汇记录 - 福鑫-OpenAPI v2

请求参数

Query 参数

source_type

string

可选

订单来源(spot:"实时换汇",lock:"预约换汇")

示例值:

spot

status

string

可选

订单状态(waitSettle:"待履约" ,settle:"已履约")

示例值:

settle

position_id

string

合约id

可选

示例值:

230808FW477023193

value_date_begin

integer

履约日-起

可选

示例值:

1675845144000

value_date_end

integer

履约日-止

可选

示例值:

1675938744000

open_time_begin

integer

开仓时间-起

可选

示例值:

1675845144000

open_time_end

integer

开仓时间-止

可选

示例值:

1675938744000

buy_currency

string

买入货币

可选

示例值:

CNH

sell_currency

string

卖出货币

可选

示例值:

USD

trade_channel

string

可选

下单渠道(web:"页面下单",api:"api下单")

示例值:

api

page_no

integer

页码

可选

示例值:

1

page_size

integer

页面大小

可选

示例值:

10

Header 参数

access_token

string

token

必需

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://sandbox-gateway.pingpongx.com/v2/fx/trade/contract/page?source_type=spot&status=settle&position_id=230808FW477023193&value_date_begin=1675845144000&value_date_end=1675938744000&open_time_begin=1675845144000&open_time_end=1675938744000&buy_currency=CNH&sell_currency=USD&trade_channel=api&page_no=1&page_size=10' \
--header 'access_token;'

返回响应

🟢200成功

application/json

Body

code

integer

请求结果

必需

message

string

请求信息

必需

data

object

返回结果

可选

total

integer

总条数

可选

records

array [object {20}]

可选

示例

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

{
  "code": 0,
  "data": {
    "total": 1,
    "records": [
      {
        "base_currency": "USD",
        "buy_currency": "CNH",
        "sell_currency": "USD",
        "status_desc": "已履约",
        "trade_channel": "api",
        "open_time": 1691564845000,
        "source_type": "spot",
        "buy_amount": 3595.37,
        "pay_way": "balance",
        "base_currency2": "CNH",
        "price": 7.19073,
        "sell_amount": 500,
        "position_id": "230809SP841147978",
        "price2": 0.139068,
        "status": "settle",
        "value_date": "2023-08-09"
      }
    ]
  },
  "message": "ok"
}