Skip to main content
GET
/
api
/
v1
/
tracker
/
kya
/
address
/
counterparties
Retrieve Address TopN Counterparties
curl --request GET \
  --url https://api.bitrace.io/api/v1/tracker/kya/address/counterparties \
  --header 'X-Access-Key: <api-key>'
{
  "success": true,
  "code": 1,
  "status": "SUCCESS",
  "data": {
    "opponents": [
      {
        "entities": [
          {
            "entityName": "Phishing Scam.Behavior",
            "entityCode": "phishing1-5",
            "entityCategory": "scam",
            "entityCategoryCode": "scam"
          }
        ],
        "risks": [
          {
            "riskLevel": "high",
            "riskType": "scam"
          },
          {
            "riskLevel": "high",
            "riskType": "online-gambling"
          }
        ],
        "dir": "in",
        "chain": "tron",
        "address": "TQQEMz8hWYLHbPePN7fGEsjAtrBGMkm3io",
        "amount": 0.0000021624,
        "symbol": "USDT",
        "transactionNumbers": 8
      },
      {
        "entities": [
          {
            "entityName": "Phishing Scam.Behavior",
            "entityCode": "phishing1-5",
            "entityCategory": "scam",
            "entityCategoryCode": "scam"
          }
        ],
        "risks": [
          {
            "riskLevel": "high",
            "riskType": "scam"
          }
        ],
        "dir": "in",
        "chain": "tron",
        "address": "TYuqajDCX2AfEPpyBBLgnstntFsDDM6juv",
        "amount": 0.0000016218,
        "symbol": "USDT",
        "transactionNumbers": 6
      },
      {
        "entities": [
          {
            "entityName": "Phishing Scam.Behavior",
            "entityCode": "phishing1-5",
            "entityCategory": "scam",
            "entityCategoryCode": "scam"
          }
        ],
        "risks": [
          {
            "riskLevel": "high",
            "riskType": "scam"
          },
          {
            "riskLevel": "high",
            "riskType": "online-gambling"
          }
        ],
        "dir": "in",
        "chain": "tron",
        "address": "TUk7PALXpVBj7jBaXtZV3YmWUJG8P5m3io",
        "amount": 0.0000010812,
        "symbol": "USDT",
        "transactionNumbers": 4
      },
      {
        "entities": [
          {
            "entityName": "OTC-369.Client",
            "entityCode": "9-469-client",
            "entityCategory": "otc",
            "entityCategoryCode": "otc"
          }
        ],
        "risks": [
          {
            "riskLevel": "generally-high",
            "riskType": "online-gambling"
          }
        ],
        "dir": "in",
        "chain": "tron",
        "address": "THrUtUZuFkEiQL8VtmeDhkbnmw5gekvkiX",
        "amount": 577336,
        "symbol": "USDT",
        "transactionNumbers": 2
      },
      {
        "entities": [
          {
            "entityName": "Binance.User",
            "entityCode": "binance-user",
            "entityCategory": "cex",
            "entityCategoryCode": "cex"
          }
        ],
        "risks": [
          {
            "riskLevel": "generally-high",
            "riskType": "online-gambling"
          }
        ],
        "dir": "out",
        "chain": "tron",
        "address": "TKwKrtkXRS79DK8JGVCtF76foX9iQbp3io",
        "amount": 129597,
        "symbol": "USDT",
        "transactionNumbers": 3
      }
    ]
  },
  "msg": "SUCCESS"
}

Authorizations

X-Access-Key
string
header
required

API key authentication

Headers

Content-Type
enum<string>
default:application/json
Available options:
application/json
Accept
enum<string>
default:application/json
Available options:
application/json

Query Parameters

address
string
required

The targe address

network
enum<string>
required

The supported chainns short name, ethereum tron btc

Available options:
ethereum,
eth,
tron,
btc,
bsc

Response

Successful response

success
boolean

Request success or not

code
integer

Response code (1 for success, other numbers for errors)

msg
string

SUCCESS or error message

data
object