# ประวัติยอดคงเหลือ

## คำขอ

```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` | หมายเหตุของเหตุการณ์ |
