# 余额历史

## 请求

```bash
curl -X POST https://api.bitsby.app/billing/history \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
  -F "offset=0" \
  -F "limit=10"
```

## 请求参数

| 参数     | 数据类型 | 说明                     | 示例 | 是否必填 | 默认值 |
| -------- | -------- | ------------------------ | ---- | -------- | ------ |
| `offset` | Integer  | 返回的第一条记录的序号   | 0    | 否       | 0      |
| `limit`  | Integer  | 希望获取的记录数         | 50   | 否       | 10     |

## 响应示例

```json
{
    "result": "success",
    "data": [
        {
            "datetime": "2024-11-30 18:02:41",
            "event": "other",
            "projectId": null,
            "target": "internal",
            "amount": 5,
            "comment": "welcome bonus 5"
        },
        {
            "datetime": "2025-08-15 02:00:01",
            "event": "commission",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "target": "internal",
            "amount": -0.15,
            "comment": "Commission 14.08.2025 (Sample project)"
        }
    ]
}
```

## 响应参数

| 参数        | 说明                                                                                |
| ----------- | ----------------------------------------------------------------------------------- |
| `datetime`  | 事件日期和时间                                                                      |
| `event`     | 事件类型。可选值：deposit、withdrawal、transfer、commission、aml、other             |
| `projectId` | 操作所属项目的 ID。账户级操作——充值和赠金——为 null                                  |
| `target`    | 发生变动的余额。可选值：internal、partner                                           |
| `amount`    | 余额变动的金额                                                                      |
| `comment`   | 事件备注                                                                            |