账单流水

当前用户的充值、消费与退款流水。代理、号码、邮箱、验证码识别的购买结果不明时，用本接口与对应的记录接口一起核对，再决定是否重新购买。

在本页搜索

显示 1 / 1 个接口

GET/billing/trades

账单流水列表

分页查询当前用户的充值、消费与退款流水，用于核对购买与退款结果。

鉴权Bearer API Key

请求参数

字段	类型	是否必填	说明
page	number	可选	页码，默认 1
size	number	可选	每页数量，默认 20，上限 1000

注意事项

• 请按 type 判断业务，不要按 typeRemark 或 remark 文本分支。
• 流水只用于核对，不是购买的幂等凭证；本接口不接受 keyword。

响应字段

字段	类型	说明
contextId	string	本次请求的登录与团队上下文标识，可作为后续请求的 X-Nex-Service-Context
data.count	number	匹配到的总条数
data.size	number	每页数量，回显请求值
data.page	number	当前页码，回显请求值
data.total	number	总页数
data.data	object[]	当前页记录
data.data[].id	number	流水 ID
data.data[].userId	number	用户 ID
data.data[].amount	number	金额，USDT；正数为入账，负数为出账
data.data[].type	string	流水类型，如 RECHARGE、BUY_PROXY_IP、BUY_SMS、BUY_SMS_REFUND、BUY_MAIL、BUY_CAPTCHA、BUY_CAPTCHA_REFUND
data.data[].typeRemark	string	类型说明，按 Accept-Language 翻译
data.data[].remark	string	流水备注，标准备注按 Accept-Language 翻译
data.data[].createdAt	string	创建时间
data.data[].updatedAt	string	更新时间

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "count": 1,
    "size": 20,
    "page": 1,
    "total": 1,
    "data": [
      {
        "id": 88001,
        "userId": 1001,
        "amount": -0.005,
        "type": "BUY_CAPTCHA",
        "typeRemark": "验证码识别购买",
        "remark": "验证码识别购买 RECAPTCHA_V2",
        "createdAt": "2026-10-23 10:00:00",
        "updatedAt": "2026-10-23 10:00:00"
      }
    ]
  },
  "contextId": "a3f5c2e1b7d94c0e8f6a1b2c3d4e5f60a3f5c2e1b7d94c0e8f6a1b2c3d4e5f6"
}