> For the complete documentation index, see [llms.txt](https://docs.blockchainsecurity.asia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockchainsecurity.asia/api-reference/readme/on-chain-data/di-zhi-yueli-shi.md).

# 地址餘額歷史

查詢指定地址持有某項資產的歷史餘額變化，回傳每日餘額序列。適合繪製持倉走勢或觀察資產增減。

## POST /v1/balance-history

>

```json
{"openapi":"3.1.0","info":{"title":"Blockchain Atlantis API Gateway","version":"0.1.0"},"tags":[{"description":"查詢指定地址持有某項資產的歷史餘額變化，回傳每日餘額序列。適合繪製持倉走勢或觀察資產增減。","name":"地址餘額歷史"}],"servers":[{"description":"Production","url":"https://api.blockchainsecurity.asia"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"in":"header","name":"X-API-Key","type":"apiKey"}},"schemas":{"BalanceHistoryRequest":{"description":"`POST /v1/balance-history` 的請求 body（每日餘額變化 / 歷史餘額）。\n\n以單一資產為主，通常帶一個 symbol / contract；回應含每日 data_points\n與 `final_balance`。","properties":{"address":{"type":"string"},"blockchain":{"type":"string"},"contracts":{"items":{"type":["string","null"]},"type":["array","null"]},"end_time":{"format":"int64","type":["integer","null"]},"output_asset":{"type":["string","null"]},"start_time":{"format":"int64","type":["integer","null"]},"symbols":{"items":{"type":"string"},"type":["array","null"]},"timezone":{"description":"UTC 偏移小時數。","format":"int32","type":["integer","null"]},"unit":{"description":"目前僅支援 `daily`。","type":["string","null"]}},"required":["blockchain","address"],"type":"object"}}},"paths":{"/v1/balance-history":{"post":{"operationId":"balance_history","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceHistoryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{}},"description":"查詢成功，回傳每日餘額變化與最終餘額"},"400":{"description":"請求參數有誤，請檢查輸入內容"},"401":{"description":"缺少或無效的 API key"}},"summary":"","tags":["地址餘額歷史"]}}}}
```