> 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-jiao-yi-ji-lu.md).

# 地址交易紀錄

查詢指定地址的交易紀錄，並可依資產、金額、時間區間與收付方向篩選。適合檢視地址的資金往來明細。

## POST /v1/transactions

>

```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":{"TransactionsRequest":{"description":"`POST /v1/transactions` 的請求 body。","properties":{"address":{"description":"查詢的地址。","type":"string"},"blockchain":{"description":"鏈別（ethereum / bsc / tron …）。","type":"string"},"contracts":{"description":"contract-first：合約位址清單（與 symbols 二擇一，較防偽）。","items":{"type":["string","null"]},"type":["array","null"]},"direction":{"type":["string","null"]},"end_time":{"format":"int64","type":["integer","null"]},"filter_criterias":{"description":"進階：per-symbol 金額區間篩選。","items":{"$ref":"#/components/schemas/FilterCriteria"},"type":["array","null"]},"limit":{"format":"int32","minimum":0,"type":["integer","null"]},"output_asset":{"type":["string","null"]},"page":{"format":"int32","minimum":0,"type":["integer","null"]},"start_time":{"format":"int64","type":["integer","null"]},"symbols":{"description":"要看的幣種 symbol；省略 / 含 `all` 代表全部。","items":{"type":"string"},"type":["array","null"]}},"required":["blockchain","address"],"type":"object"},"FilterCriteria":{"description":"幣別篩選條件（交易列表用）。","properties":{"max_value":{"format":"double","type":["number","null"]},"min_value":{"format":"double","type":["number","null"]},"sign":{"type":["string","null"]},"symbol":{"type":"string"}},"required":["symbol"],"type":"object"}}},"paths":{"/v1/transactions":{"post":{"operationId":"transactions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{}},"description":"查詢成功，回傳符合條件的交易明細列表"},"400":{"description":"請求參數有誤，請檢查輸入內容"},"401":{"description":"缺少或無效的 API key"}},"summary":"","tags":["地址交易紀錄"]}}}}
```