资金流水

GET/api/v1/px/ledgerBearer

PX 发现与账户一律 E6 十进制字符串A | B

账户资金变更逐条流水，最新在前。balanceAfterE6 是该条生效后的余额，refId 指向引发它的对象（订单、强平、结算等，按 kind 决定值域）。

这是对账的唯一权威读端点：持仓与订单是投影，流水是账本。

请求头 Authorization: Bearer <token>。token 由 POST /api/v1/auth/verify 签发，24h 空闲或签发满 7d 后失效。

查询参数

limitintegerquery可选
返回条数上限
默认100范围≥ 1示例20

响应

200流水列表

entriesobject(PxLedgerEntry)[]
资金流水，最新在前
entryIdstring
流水 id
示例"entry_01K5H2M3N7"
kindstring
变更类型；决定 refId 的值域
amountE6string
变更金额，E6 字符串；出账为负
balanceAfterE6string
该条生效后的余额，E6 字符串
refIdstring可为空
引发该条的对象 id，按 kind 决定值域
createdAtstring可为空
发生时刻

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/px/ledger?limit=100" \
  -H "Authorization: Bearer $TOKEN"

响应

流水列表

{
  "entries": [
    {
      "entryId": "entry_01K5H2M3N7",
      "kind": "<kind>",
      "amountE6": "<amountE6>",
      "balanceAfterE6": "<balanceAfterE6>",
      "refId": null,
      "createdAt": null
    }
  ]
}