分页查询换汇记录 - 福鑫-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"
}