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

分页查询挂单记录

GET
/v2/fx/trade/limit/order/page
order_status 枚举:accept("生效中") , cancel("已取消") , reject("已拒绝") , waitSettle("待履约") ,settle("已履约")

请求参数

Query 参数
order_status
string 
可选
订单状态(accept:"生效中",cancel:"已取消",reject:"已拒绝",waitSettle:"待履约")
示例值:
accept
order_time_start
integer 
挂单时间-起
可选
示例值:
1675845144000
order_time_end
integer 
挂单时间-止
可选
示例值:
1675938744000
trade_channel
string 
可选
下单渠道(web:"页面下单",api:"api下单")
示例值:
api
order_expire_time_sort
string 
可选
有效截止日期排序(desc,asc)
示例值:
desc
order_time_sort
string 
可选
下单时间排序(desc,asc)
示例值:
desc
buy_currency
string 
买入货币
可选
示例值:
CNH
sell_currency
string 
卖出货币
可选
示例值:
USD
page_no
integer 
页码(默认1)
可选
示例值:
1
page_size
integer 
可选
页面大小(默认10,最大100)
示例值:
10
Header 参数
access_token
string 
token
必需

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sandbox-gateway.pingpongx.com/v2/fx/trade/limit/order/page?order_status=accept&order_time_start=1675845144000&order_time_end=1675938744000&trade_channel=api&order_expire_time_sort=desc&order_time_sort=desc&buy_currency=CNH&sell_currency=USD&page_no=1&page_size=10' \
--header 'access_token;'

返回响应

🟢200成功
application/json
Body
code
integer 
请求结果
必需
message
string 
请求信息
必需
data
object 
返回结果
可选
total
integer 
总条数
可选
records
array [object {12}] 
可选
示例
{
    "code": 0,
    "data": {
        "records": [
            {
                "buy_amount": 0.7,
                "buy_currency": "CNH",
                "order_id": "230209LE714107442",
                "order_time": 1675939823000,
                "pay_way": "balance",
                "sell_amount": 0.1,
                "sell_currency": "USD",
                "status": "accept",
                "status_desc": "已接受",
                "valid_date": 1677167999000
            },
            {
                "buy_amount": 1,
                "buy_currency": "USD",
                "order_id": "230209LE208832854",
                "order_time": 1675939753000,
                "pay_way": "credit",
                "sell_amount": 6.81,
                "sell_currency": "CNH",
                "status": "cancel",
                "status_desc": "已取消",
                "valid_date": 1677772799000
            },
            {
                "buy_amount": 0.91,
                "buy_currency": "CNH",
                "order_id": "230202LE472300102",
                "order_time": 1675322759000,
                "pay_way": "credit",
                "sell_amount": 0.13,
                "sell_currency": "USD",
                "status": "accept",
                "status_desc": "已接受",
                "valid_date": 1676217599000
            },
            {
                "buy_amount": 1,
                "buy_currency": "CNH",
                "order_id": "230202LE727537975",
                "order_time": 1675322577000,
                "pay_way": "balance",
                "sell_amount": 0.13,
                "sell_currency": "USD",
                "status": "accept",
                "status_desc": "已接受",
                "valid_date": 1676044799000
            },
            {
                "buy_amount": 0.88,
                "buy_currency": "CNH",
                "order_id": "230202LE570638827",
                "order_time": 1675321185000,
                "pay_way": "balance",
                "sell_amount": 0.1,
                "sell_currency": "USD",
                "status": "cancel",
                "status_desc": "已取消",
                "valid_date": 1675871999000
            },
            {
                "buy_amount": 0.88,
                "buy_currency": "CNH",
                "order_id": "230202LE207518434",
                "order_time": 1675320488000,
                "pay_way": "balance",
                "sell_amount": 0.1,
                "sell_currency": "USD",
                "status": "cancel",
                "status_desc": "已取消",
                "valid_date": 1675871999000
            },
            {
                "buy_amount": 0.88,
                "buy_currency": "CNH",
                "order_id": "230202LE760651259",
                "order_time": 1675320179000,
                "pay_way": "balance",
                "sell_amount": 0.1,
                "sell_currency": "USD",
                "status": "cancel",
                "status_desc": "已取消",
                "valid_date": 1675871999000
            },
            {
                "buy_amount": 0.88,
                "buy_currency": "CNH",
                "order_id": "230202LE145642438",
                "order_time": 1675319983000,
                "pay_way": "balance",
                "sell_amount": 0.1,
                "sell_currency": "USD",
                "status": "cancel",
                "status_desc": "已取消",
                "valid_date": 1675871999000
            },
            {
                "buy_amount": 0.88,
                "buy_currency": "CNH",
                "order_id": "230202LE673603739",
                "order_time": 1675317192000,
                "pay_way": "balance",
                "sell_amount": 0.1,
                "sell_currency": "USD",
                "status": "cancel",
                "status_desc": "已取消",
                "valid_date": 1675871999000
            },
            {
                "buy_amount": 9,
                "buy_currency": "CNH",
                "order_id": "230201LE721220164",
                "order_time": 1675243664000,
                "pay_way": "balance",
                "sell_amount": 1,
                "sell_currency": "USD",
                "status": "accept",
                "status_desc": "已接受",
                "valid_date": 1679068799000
            }
        ],
        "total": 24
    },
    "message": "ok"
}
上一页
根据幂等单号查询换汇记录
下一页
取消挂单
Built with