交易历史查询
GET
查询账户的交易历史记录,支持分页查询。适用于对账和财务报表生成。
bearerAuthheader
鉴权Bearer <令牌>通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。
accountNumber*string账户号码。长度 16
currency*stringISO 4217 货币代码。长度 3
startDate*string开始日期。格式 yyyyMMdd,长度 8
endDate*string结束日期。格式 yyyyMMdd,长度 8
pageToken?string分页令牌,翻页使用。长度 50
currentPage*integer当前页码,起始页为 1
pageSize*integer每页记录数,最大 100
X-Channel-Provider*string渠道提供商标识,如 GLDB
返回交易记录。
application/json- response
code?integer业务状态码
message?stringtraceId?string请求追踪 ID。联系技术支持时请提供
data?业务数据基类字段。所有业务响应的 data 对象中都包含这些字段(手续费预估除外)。
curl -X GET 'https://api.test.stabofx.com/openapi/v1/payments/transaction/history?accountNumber=10000000001¤cy=SGD&startDate=20240213&endDate=20240426¤tPage=1&pageSize=20' \ -H 'X-Channel-Provider: GLDB'响应示例
{ "code": 200, "message": "OK", "traceId": "a1b2c3d4-e5f6-7890", "data": { "providerStatusCode": "000000", "providerMessage": "ok", "providerRequestSerialNo": "795883203712778240", "providerResponseSerialNo": "785957885476737024", "providerTimestamp": "2023-05-17 21:03:48", "totalRecords": 12, "pageToken": "202411153825756049.01,6", "records": [ { "transactionReference": "FT24320XW3NC", "transactionDate": "2024-11-15", "transactionTime": "09:33", "currency": "SGD", "balance": "31900312.79", "amount": "-31", "remarks": "To Acc.No.- 10000000002", "valueDate": "2024-11-15", "transactionDescription": "Transfer Out", "transactionType": "213", "direction": "OUTGOING" } ] }}