> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/billing/transactions — 钱包交易历史

> 以游标分页列出钱包交易（充值、用量扣减、调整）。金额为带符号值，以钱包币种计。

按时间倒序列出钱包交易。交易包括充值入账、用量扣减与人工调整。金额带符号：充值为正，扣减为负。

**方法：** `GET` **路径：** `/api/billing/transactions` **认证：** 会话 Bearer

## 查询参数

<ParamField query="limit" type="number">
  返回的最大交易数。默认 `50`。
</ParamField>

<ParamField query="cursor" type="string">
  来自上一次响应 `next_cursor` 的不透明游标。
</ParamField>

## 响应

<ResponseField name="transactions" type="object[]">
  <Expandable title="transaction">
    <ResponseField name="id" type="string">
      稳定标识。
    </ResponseField>

    <ResponseField name="type" type="string">
      `topup`、`usage` 或 `adjustment`。
    </ResponseField>

    <ResponseField name="amount" type="number">
      以 `currency` 计价的带符号金额。
    </ResponseField>

    <ResponseField name="currency" type="string">
      `USD` 或 `CNY`。
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 时间戳。
    </ResponseField>

    <ResponseField name="description" type="string">
      简短的可读描述。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="next_cursor" type="string">
  下一页游标，末尾为 `null`。
</ResponseField>

## 示例

```bash theme={null}
curl -H "Authorization: Bearer eyJhbGciOi..." \
  "https://ariacompute.cn/api/billing/transactions?limit=20"
```

```json theme={null}
{
  "transactions": [
    {
      "id": "txn_01H...",
      "type": "usage",
      "amount": -0.12,
      "currency": "CNY",
      "created_at": "2026-09-23T08:59:00Z",
      "description": "gemma-4-e2b-it_q4 inference"
    }
  ],
  "next_cursor": null
}
```