Skip to content

按钱包获取转账列表

GET/api/v1/transfer/query/ordersHMAC

返回指定钱包的转账订单分页列表,支持可选的时间范围筛选。

请求头

NameTypeRequiredDescription
X-Api-KeystringYesAPI 密钥标识符
X-SignaturestringYesHMAC-SHA256 签名
X-TimestampstringYesUnix 时间戳(秒)
X-NoncestringYes唯一请求标识符(UUID)

查询参数

NameTypeRequiredDescription
walletIdstringYes钱包业务 ID
startTimestringNo起始时间筛选(ISO-8601 日期时间格式)
endTimestringNo结束时间筛选(ISO-8601 日期时间格式)

请求示例

curl -X GET "https://api.slaunchx.cc/api/v1/transfer/query/orders?walletId=<walletId>&startTime=<startTime>&endTime=<endTime>" \
  -H "X-Api-Key: sk_live_xxx" \
  -H "X-Signature: <computed_signature>" \
  -H "X-Timestamp: 1709337600" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000"

响应

成功200
{
  "version": "1.3.0",
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "content": [
      {
        "bizId": "txn_ghi789",
        "fromWalletId": "wlt_sender_001",
        "toWalletId": "wlt_receiver_002",
        "currency": "USD",
        "amount": 100.5,
        "feeAmount": 0.5,
        "totalAmount": 101,
        "status": 10060102,
        "statusName": "COMPLETED",
        "failureReason": null,
        "remark": "Monthly payment",
        "createdAt": "2026-03-02T11:20:00Z",
        "completedAt": "2026-03-02T11:20:03Z"
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "size": 20,
    "number": 0,
    "first": true,
    "last": true,
    "empty": false
  }
}

Last updated: