APIs

Subscription

Subscribe to our plan to use this API in your service to help meet the compliance requirements and save users' assets.

Get Supported Chains

Get the list of supported chains.

get

Authorizations

Header parameters

API-KEYstringRequired

Responses

get

HTTPcURLJavaScriptPython

GET /address-compliance/api/v3/chain-list HTTP/1.1
Host: aml.blocksec.com
API-KEY: text
Accept: */*

200

A successful resquest

{
  "request_id": "a11b2d3cf7834e0f",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "chain_id": -3,
      "chain_name": "SOLANA",
      "support_interaction_risk": true
    },
    {
      "chain_id": -2,
      "chain_name": "TRX",
      "support_interaction_risk": true
    },
    {
      "chain_id": -1,
      "chain_name": "BTC",
      "support_interaction_risk": true
    },
    {
      "chain_id": 1,
      "chain_name": "ETH",
      "support_interaction_risk": true
    }
  ]
}

Get Risk Indicators

Retrieve a comprehensive list of all risk indicators.

get

Authorizations

Header parameters

API-KEYstringRequired

Responses

get

HTTPcURLJavaScriptPython

GET /address-compliance/api/v3/risk-items HTTP/1.1
Host: aml.blocksec.com
API-KEY: text
Accept: */*

200

A successful resquest

{
  "request_id": "701ade74594943b2",
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "name": "DARKWEB BUSINESS",
      "code": 5001
    },
    {
      "name": "CHILD ABUSE MATERIAL",
      "code": 5002
    },
    {
      "name": "MIXER",
      "code": 5003
    },
    {
      "name": "SCAM",
      "code": 5005
    },
    {
      "name": "SANCTIONED",
      "code": 5006
    }
  ]
}

Get Address Compliance Risk

Retrieve the address's risk score and all associated risk indicators.

post

Authorizations

Header parameters

API-KEYstringRequired

Body

chain_idintegerOptional

Chain ID. Please refer to the 'Supported Networks' section for specific IDs.

addressstringOptional

The specific address you want to query. EVM addresses are case-insensitive, while non-EVM addresses are case-sensitive.

interaction_riskbooleanOptional

Whether to calculate the interaction risk of the queried address.

Responses

post

HTTPcURLJavaScriptPython

POST /address-compliance/api/v3/risk-score HTTP/1.1
Host: aml.blocksec.com
API-KEY: text
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "chain_id": -2,
  "address": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
  "interaction_risk": true
}

200

A successful request

{
  "request_id": "2694550636314f27",
  "code": 200000,
  "message": "Success",
  "data": {
    "request_id": "f8c8b448531544fa",
    "code": 200000,
    "message": "Success",
    "data": {
      "chain_id": -2,
      "address": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
      "risk_score": 4,
      "risk_indicators": [
        {
          "type": "Interaction Risk",
          "indicator": {
            "name": "Child Abuse Material",
            "code": 5002
          },
          "source ": "TUQbf1PgWvxKethbrYLFY842UL6Z41RiKC",
          "risk_interactions": [
            {
              "block_number": 58020393,
              "timestamp": "1704694983",
              "tx_hash": "04f7d318f7f20fa70fd2c08a19416456477258c347c4ec3f12a1e673dfdc55e9",
              "from": "TUQbf1PgWvxKethbrYLFY842UL6Z41RiKC",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 1854,
              "usd_value": 1867.91427
            },
            {
              "block_number": 58032108,
              "timestamp": "1704730134",
              "tx_hash": "7fdad2ae6f852868f816b2369527972444051d0cff8ee584992d268d951f745a",
              "from": "TUQbf1PgWvxKethbrYLFY842UL6Z41RiKC",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 65,
              "usd_value": 65.487825
            },
            {
              "block_number": 58495156,
              "timestamp": "1706119941",
              "tx_hash": "db44cf8d89cf6b5771a1f71878081b8b54f151228ee37a737848a6c6fcb165d1",
              "from": "TUQbf1PgWvxKethbrYLFY842UL6Z41RiKC",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 3125,
              "usd_value": 3148.453125
            },
            {
              "block_number": 58676396,
              "timestamp": "1706663814",
              "tx_hash": "2ba1845e914a1ff248041ff9f376c16523c631306407fba023b18023df965826",
              "from": "TUQbf1PgWvxKethbrYLFY842UL6Z41RiKC",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 545,
              "usd_value": 549.090225
            },
            {
              "block_number": 58722612,
              "timestamp": "1706802501",
              "tx_hash": "35dc1451ea09fbf5aeeca1c74f60a433ad1132d58504b4eb0034fa7fa4f6c567",
              "from": "TUQbf1PgWvxKethbrYLFY842UL6Z41RiKC",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 162.13,
              "usd_value": 163.34678565
            }
          ]
        },
        {
          "type": "Interaction Risk",
          "indicator": {
            "name": "Child Abuse Material",
            "code": 5002
          },
          "source ": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
          "risk_interactions": [
            {
              "block_number": 58780047,
              "timestamp": "1706974857",
              "tx_hash": "3d1d9dda94a34b606c5ba00b719ddb183bf8e6e219cffebb7785527e84278be9",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 197.8,
              "usd_value": 199.284489
            },
            {
              "block_number": 58852638,
              "timestamp": "1707192690",
              "tx_hash": "21a89f8206571d930ae28340272d0724ac043119a6ff412a96b1a88326b390e3",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 205,
              "usd_value": 206.538525
            },
            {
              "block_number": 59473083,
              "timestamp": "1709054595",
              "tx_hash": "ac6ff8943583b60b4532be13c60054ec3afd82df37617ffb6a70c5de1fb88b31",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 1106.1,
              "usd_value": 1114.4012805
            },
            {
              "block_number": 59499315,
              "timestamp": "1709133315",
              "tx_hash": "5de6810ab0087fcfbe37950af8a45a706ba493ee97d5e598cf9b2c1e2733cedb",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 1546,
              "usd_value": 1557.60273
            },
            {
              "block_number": 59810463,
              "timestamp": "1710067038",
              "tx_hash": "4ab9e00048f40b04c90bbe89a446855bd2ebaedb405e15176e45fadd6386f7b6",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 396.7,
              "usd_value": 399.6772335
            },
            {
              "block_number": 59981396,
              "timestamp": "1710584886",
              "tx_hash": "f83c771c44daa50e9f541eaaedf9fe9df52107c77f504178f342bae745966b25",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 364,
              "usd_value": 366.73182
            },
            {
              "block_number": 60032414,
              "timestamp": "1710737982",
              "tx_hash": "eea6aae7dbc64080b08444ae8b9bd4c725e5b7d5fb6f05672e744e801bc621a6",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 126.4,
              "usd_value": 127.34863200000001
            },
            {
              "block_number": 60147528,
              "timestamp": "1711083531",
              "tx_hash": "c37ff83c6d5b4c28d85bff6b87288c15d51533c70b7c19b5493de4f7d1f3213c",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 201.6,
              "usd_value": 203.113008
            },
            {
              "block_number": 60537953,
              "timestamp": "1712255241",
              "tx_hash": "88bd543432eceadd90c7017d792983b681ccca7c90ef24d2cf32a57bffc2bd73",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 3029.85,
              "usd_value": 3052.58902425
            },
            {
              "block_number": 60617355,
              "timestamp": "1712493522",
              "tx_hash": "17458cfae7f38f1eba14ff77f7ac3080e40c3e18187ac06e6a64ffe2df661a4e",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 372,
              "usd_value": 374.79186
            },
            {
              "block_number": 61138819,
              "timestamp": "1714059045",
              "tx_hash": "6eb1c28cfa4a89405d8ce62c345fdd532a375719830c2b4fa2bb9d6c26e9654f",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 1098,
              "usd_value": 1106.24049
            },
            {
              "block_number": 61368600,
              "timestamp": "1714748580",
              "tx_hash": "c9bbb77601740b1a622cab17ae26e4106048c8794c6d2d02ce5120a1ad51c70f",
              "from": "TA2G85LLXqtbcMwwZUKn4gDdQ9EkoHRp8V",
              "to": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
              "token_contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
              "token_symbol": "USDT",
              "amount": 216.7,
              "usd_value": 218.32633349999998
            }
          ]
        }
      ]
    }
  }
}