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.

GEThttps://aml.blocksec.com/address-compliance/api/v3/chain-list

Authorization

APIKey

Header parameters

Response

200

A successful resquest

Body

application/json

request_idstring

Example: "a11b2d3cf7834e0f"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://aml.blocksec.com/address-compliance/api/v3/chain-list', {
    method: 'GET',
    headers: {
      "API-KEY": "text"
    },
});
const data = await response.json();

Response

200

{
  "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.

GEThttps://aml.blocksec.com/address-compliance/api/v3/risk-items

Authorization

APIKey

Header parameters

Response

200

A successful resquest

Body

application/json

request_idstring

Example: "701ade74594943b2"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataarray of object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://aml.blocksec.com/address-compliance/api/v3/risk-items', {
    method: 'GET',
    headers: {
      "API-KEY": "text"
    },
});
const data = await response.json();

Response

200

{
  "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.

POSThttps://aml.blocksec.com/address-compliance/api/v3/risk-score

Authorization

APIKey

Header parameters

Body

application/json

chain_idinteger

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

addressstring

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

interaction_riskboolean

Whether to calculate the interaction risk of the queried address.

Response

200

A successful request

Body

application/json

request_idstring

Example: "2694550636314f27"

codeinteger

Example: 200000

messagestring

Example: "Success"

dataobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://aml.blocksec.com/address-compliance/api/v3/risk-score', {
    method: 'POST',
    headers: {
      "API-KEY": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "chain_id": -2,
      "address": "TJXSFyP1CsHxN4oEjG2QGNFT3DWWuoS4C4",
      "interaction_risk": true
    }),
});
const data = await response.json();

Response

200

{
  "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
            }
          ]
        }
      ]
    }
  }
}