---
title: "分批读取待导出的钱包流水"
method: GET
path: "/v1/console/wallet/ledger/export"
tags: ["WalletService"]
---

# 分批读取待导出的钱包流水

`GET /v1/console/wallet/ledger/export`

使用固定上界的不透明游标分批读取当前用户钱包流水；不执行 COUNT 或 OFFSET。cursor 为空表示首批，后续必须原样传回 nextCursor。

## Query parameters

- `pageSize` integer
- `direction` '' | 'credit' | 'debit'
- `cursor` string

## Response `200`

OK

- WalletV1ListLedgerExportReply
  - `hasMore` boolean
  - `items` WalletV1LedgerEntry[]
    - `amountMicros` string — amount_micros 变动金额（微单位，绝对值）
    - `balanceAfterMicros` string — balance_after_micros 变动后余额（微单位）
    - `bizType` string — biz_type 业务类型：topup=充值 consume=消费 refund=退款 adjust=调整 reward=奖励 violation_fee=内容违规扣费（上游对违规请求收费，非正常模型消费）
    - `createdAt` string, date-time
    - `currency` string
    - `direction` string — direction 流水方向：credit=入账 debit=出账
    - `id` string
    - `remark` string — remark 备注（如违规扣费的关联请求 ID）；无备注时为空串
    - `walletId` string
  - `nextCursor` string

## Changes

- **2026-09-03** `a4b851fa3bdd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/apiqik/apis/apiqik-api/changes/v1/console/wallet/ledger/export/get.md)

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/a4b851fa3bdd/schema)
