> 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-dui-shou.md).

# 地址交易對手

列出指定地址曾往來的對手地址，並可依往來總額或交易筆數排序與篩選。適合找出主要資金往來對象。

## POST /v1/counterparty

>

```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":{"CounterpartyRequest":{"description":"`POST /v1/counterparty` 的請求 body（交易對手排行）。","properties":{"address":{"type":"string"},"blockchain":{"type":"string"},"contracts":{"items":{"type":["string","null"]},"type":["array","null"]},"direction":{"type":["string","null"]},"end_time":{"format":"int64","type":["integer","null"]},"limit":{"format":"int32","minimum":0,"type":["integer","null"]},"min_interactions":{"format":"int32","minimum":0,"type":["integer","null"]},"order":{"type":["string","null"]},"output_asset":{"type":["string","null"]},"page":{"format":"int32","minimum":0,"type":["integer","null"]},"sort":{"type":["string","null"]},"start_time":{"format":"int64","type":["integer","null"]},"symbols":{"items":{"type":"string"},"type":["array","null"]}},"required":["blockchain","address"],"type":"object"}}},"paths":{"/v1/counterparty":{"post":{"operationId":"counterparty","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterpartyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{}},"description":"查詢成功，回傳交易對手清單與往來排行"},"400":{"description":"請求參數有誤，請檢查輸入內容"},"401":{"description":"缺少或無效的 API key"}},"summary":"","tags":["地址交易對手"]}}}}
```