Live AML/ KYT

What is this request?

This is the live version of the address security service. With this service, the wallets you follow will notify you when they make a bad transaction.

What can I do with this service?

With this service, secure the wallets on our platform and minimize all possible risks. Be aware of everything instantly.

Tutorial

var axios = require('axios');

// Create Live AML Account Tracking
axios.get('https://api.getdefy.co/aml/live_aml/create', {
    params: {
      address: '0x787970ad122d5947579e613c2464d9540081b46f',
      key: 'API_KEY',
      webhook: 'WEBHOOK_URL',
      stream_webhook: 'STREAM_WEBHOOK_URL'
    },
  })
  .then(function (response) {
    console.log(JSON.stringify(response.data));
  })
  .catch(function (error) {
    console.log(error);
  });

// Delete Live AML Account Tracking
axios.get('https://api.getdefy.co/aml/live_aml/delete', {
    params: {
      address: '0x787970ad122d5947579e613c2464d9540081b46f',
      key: 'API_KEY'
    },
  })
  .then(function (response) {
    console.log(JSON.stringify(response.data));
  })
  .catch(function (error) {
    console.log(error);
  });

// List Tracked Accounts and webhook list
axios.get('https://api.getdefy.co/aml/live_aml/get', {
    params: {
      key: 'API_KEY'
    },
  })
  .then(function (response) {
    console.log(JSON.stringify(response.data));
  })
  .catch(function (error) {
    console.log(error);
  });
  
// List Tracked Accounts Actions
axios.get('https://api.getdefy.co/aml/live_aml/events', {
    params: {
      key: 'API_KEY'
    },
  })
  .then(function (response) {
    console.log(JSON.stringify(response.data));
  })
  .catch(function (error) {
    console.log(error);
  });

Options

• address (required): A user address (i.e. 0x1a2b3x...). If specified, the user attached to the query is ignored and the address will be used instead.

• key (required): API key for requests.

• language (optional): Service language. Default value is en. Can be en or tr.

• webhook (required): You will be notified with this webhook if this wallet does something bad.

• stream_webhook (optinoal): You will be notified with this webhook if this wallet does something. With this parameter you do not need any action for streaming.

After calling this request your address synchronized automatically. You can see your synchronization list here.

Example Webhook Data

With this data you can everything you want in your system.

{
  "address": "0xe2fc31f816a9b94326492132018c3aecc4a93ae1",
  "score": 13,
  "tags": {
    "mixer": false,
    "fake_kyc": false,
    "cybercrime": false,
    "new_wallet": false,
    "sanctioned": false,
    "indirect_mixer": false,
    "invalid_tokens": true,
    "financial_crime": false,
    "stealing_attack": false,
    "money_laundering": false,
    "gambling_accounts": false,
    "indirect_fake_kyc": false,
    "blacklisted_tokens": false,
    "indirect_cybercrime": false,
    "indirect_sanctioned": false,
    "phishing_activities": false,
    "blacklisted_accounts": false,
    "blackmail_activities": false,
    "darkweb_transactions": false,
    "indirect_financial_crime": false,
    "indirect_stealing_attack": false,
    "indirect_money_laundering": false,
    "indirect_gambling_accounts": false,
    "indirect_blacklisted_tokens": false,
    "indirect_phishing_activities": false,
    "indirect_blacklisted_accounts": true,
    "indirect_blackmail_activities": false,
    "indirect_darkweb_transactions": false,
    "number_of_malicious_contracts_created": false,
    "indirect_number_of_malicious_contracts_created": false
  },
  "hash": "0x31735b87f84289ab31bd12ed25542bebd814160e338536a4ac1370332841a933",
  "block_number": 848525187,
  "hash_tags": {
    "indirect_blacklisted_accounts": true
  },
  "created_at": "2023-11-06T13:24:01.652Z"
}

With this example our stream send this data for spesific hash. In this transaction this wallet contacted with mixer wallet. We are understanding this in hash_tags variables. You can see block number, hash number. Also you can see score for this wallet. Scoring means 0 is bad and 100 is good.

Create Live AML Tracking

GET https://api.getdefy.co/aml/live_aml/create

Query Parameters

Name	Type	Description
address*	String	Wallet Address
key*	String	API Key
webhook*	String	Webhook Url
stream_webhook	String	Streaming Webhook Url

400: Bad Request

{
  "message": "Error Message",
  "status": 500
}

200: OK

{
    "result": {
        "message": "OK",
        "code": 0
    },
    "data": "OK"
}

Delete Live AML Tracking

GET https://api.getdefy.co/aml/live_aml/delete

Query Parameters

Name	Type	Description
address*	String	Wallet Address
key*	String	API KEY

200: OK

{
    "result": {
        "message": "OK",
        "code": 0
    },
    "data": "OK"
}

400: Bad Request

{
  "message": "Error Message",
  "status": 500
}

List Tracked Accounts

GET https://api.getdefy.co/aml/live_aml/get

Query Parameters

Name	Type	Description
key*		API_KEY

200: OK

{
    "result": {
        "message": "OK",
        "code": 0
    },
    "data": [
        {
            "address": "0x4f797d5e551b5dc25b68298c97d68aa24ddc49d4",
            "aml_webhook": "https://webhook.site/004315c0-f2e0-4c0d-be91-aa39c773e57d",
            "created_at": "2023-03-09T15:20:18.121Z"
        }
    ]
}

400: Bad Request

{
  "message": "Error Message",
  "status": 500
}

Addresses Actions

GET https://api.getdefy.co/aml/live_aml/events

Query Parameters

Name	Type	Description
key*	String	API_KEY

200: OK

{
    "result": {
        "message": "OK",
        "code": 0
    },
    "data": []
}

400: Bad Request

{
  "message": "Error Message",
  "status": 500
}