# Live AML API

## Create Live AML

You can create live anti money laundering tracking with this service. Just add **address** and **webhook** data then we will send notification to your webhook. Also if you want set your streaming webhook you can set with this request (this is optional).

<mark style="color:orange;">`POST`</mark> `https://api.getdefy.co/v2/liveaml/create`

#### Header Parameters

| Name                                     | Type   | Description    |
| ---------------------------------------- | ------ | -------------- |
| apikey<mark style="color:red;">\*</mark> | String | Service Apikey |

#### Body Parameters

| Name                                      | Type   | Description           |
| ----------------------------------------- | ------ | --------------------- |
| address<mark style="color:red;">\*</mark> | String | Wallet Address        |
| webhook<mark style="color:red;">\*</mark> | String | Webhook URL           |
| stream\_webhook                           | String | Streaming Webhook URL |

{% tabs %}
{% tab title="200: OK " %}
{% code lineNumbers="true" %}

```json
{
    "code": 0,
    "message": "OK",
    "data": null
}
```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request " %}
{% code lineNumbers="true" %}

```json
{
    "message": "Error Message",
    "code": 5004
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Delete Live AML

You can stop your live anti money laundering tracking with this request. Just enter which address you want to stop.&#x20;

<mark style="color:blue;">`DELETE`</mark> `https://api.getdefy.co/v2/liveaml/delete`

#### Header Parameters

| Name                                     | Type   | Description    |
| ---------------------------------------- | ------ | -------------- |
| apikey<mark style="color:red;">\*</mark> | String | Service Apikey |

#### Query Parameters

| Name                                      | Type   | Description    |
| ----------------------------------------- | ------ | -------------- |
| address<mark style="color:red;">\*</mark> | String | Wallet Address |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "code": 0,
    "message": "OK",
    "data": null
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
    "message": "Error Message",
    "code": 5004
}
```

{% endtab %}
{% endtabs %}

## List Tracked Live AML Addresses

You can list your live anti money laundering tracking addresses with this request.

<mark style="color:blue;">`GET`</mark> `https://api.getdefy.co/v2/liveaml/list`

#### Header Parameters

| Name                                     | Type   | Description |
| ---------------------------------------- | ------ | ----------- |
| apikey<mark style="color:red;">\*</mark> | string | API\_KEY    |

#### Query Parameters

| Name    | Type    | Description                 |
| ------- | ------- | --------------------------- |
| page\*  | integer | Value has to be minimum 1   |
| limit\* | integer | Value has to be maximum 100 |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
            "aml_webhook": "https://www.getdefy.co/amlwebhook",
            "created_at": "2024-07-25T13:57:09.644Z",
            "has_stream": true
        }
    ],
    "page_count": 275
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
    "message": "Error Message",
    "code": 5004
}
```

{% endtab %}
{% endtabs %}

## Addresses Actions

You can list your tracked accounts notification with this request. Also you can paginate it.

<mark style="color:blue;">`GET`</mark> `https://api.getdefy.co/v2/liveaml/events`

#### Header Parameters

| Name     | Type   | Description |
| -------- | ------ | ----------- |
| apikey\* | String | API\_KEY    |

#### Query Parameters

| Name    | Type    | Description              |
| ------- | ------- | ------------------------ |
| page\*  | Integer | Page Value (Minimum 1)   |
| limit\* | Integer | Page Limit (Maximum 100) |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "id": "18944185",
            "address": "0x388c818ca8b9251b393131c08a736a67ccb19297",
            "event": {
                "hash": "0x42bdfa13f78624505f2fa727749b2a2b01add52910bf3688126d553d4b217f54",
                "tags": {
                    "mixer": false,
                    "fake_kyc": false,
                    "cybercrime": false,
                    "new_wallet": false,
                    "sanctioned": false,
                    "indirect_mixer": false,
                    "invalid_tokens": false,
                    "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": true,
                    "indirect_blacklisted_tokens": true,
                    "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
                },
                "score": 59,
                "hash_tags": {
                    "indirect_gambling_accounts": true,
                    "indirect_blacklisted_tokens": true,
                    "indirect_blacklisted_accounts": true
                },
                "block_number": 541168421
            },
            "created_at": "2024-07-30T12:20:01.211Z"
        }
    ],
    "page_count": 6656
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
{
    "message": "Error Message",
    "code": 5004
}
```

{% endtab %}
{% endtabs %}