В этом разделе представлены методы оценки рисков транзакций и адресов в блокчейне с помощью сервиса Elliptic.
Методы позволяют проверять надежность входящих и исходящих транзакций, выявлять подозрительную активность и классифицировать риски.
Также можно получить подробные отчеты о контрагентах, их долях, суммах и связях между адресами.
Эта информация помогает партнерам принимать решения по комплаенсу, предотвращать мошенничество.
Documentation
Упрощенный AML-отчет
Этот метод возвращает упрощённую оценку риска для конкретного блокчейн-адреса с использованием различных AML-сервисов. В ответе присутствуют два поля: passed и completed.
Ключ completed указывает, завершила ли наша комплаенс-система проверку рисков — иногда информация, полученная от AML-провайдеров, может быть неполной или недостаточной для наших риск-чекеров. Это первое поле, которое следует проверить — значение passed никогда не будет true, если completed равно false.
В свою очередь, ключ passed показывает, прошёл ли указанный адрес нашу проверку на риск. Подозрительный адрес всегда будет иметь "passed": false в ответе API, но только если completed установлено в true.
HTTP-запрос
Method: GET URL: /api/v2/compliance/elliptic/address-report
Пример запроса:
curl -X 'GET' \ 'https://dxspot.io/api/v2/compliance/elliptic/address-report?address=some_address' \ -H 'accept: application/json' \ -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \ -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \ -H 'X-Api-Signature: {SIGNATURE}' \
Параметры запроса
Все параметры передаются в строке запроса (query string).
Query-параметры
| Parameter | Type | Required | Description |
|---|---|---|---|
| address | string | Yes | Адрес кошелька для проверки. |
Пример ответа
{ "completed": true, "passed": true }
Поля ответа
| Field | Type | Description |
|---|---|---|
| completed | boolean | Показывает, завершила ли система комплаенса оценку рисков. Если false, результат не считается окончательным и passed никогда не будет true. |
| passed | boolean | Показывает, прошёл ли адрес проверку на риск. Если адрес подозрительный, значение будет false (имеет смысл только когда completed равно true). |
Code Sample
curl -X 'GET' \
'https://dxspot.io/api/v2/compliance/elliptic/address-report?address=TNjkHpHwV8MWT9jffLmMpHNt3Da1VFAqWY' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}' \Response Example
{
"riskScore": 9.22690254307772,
"type": "ADDRESS",
"evaluationDetailsSource": [
{
"rule_id": "cf0ca4c8-4783-4d88-8772-424e7a511f0b",
"rule_name": "Exchange_Legal",
"rule_type": "exposure",
"risk_score": 9.22690254307772,
"matched_behaviors": [],
"matched_elements": [
{
"counterparty_percentage": 71.34044036074452,
"counterparty_value": {"usd": 86217.78721520543},
"category_id": "0a52f7a2-5da8-4256-b230-df0da6f8449b",
"contribution_value": {"usd": 120854.01601003749},
"indirect_percentage": 28.659559639255473,
"indirect_value": {"usd": 34636.22879483205},
"category": "Exchange",
"contributions": [
{
"counterparty_percentage": 33.5451643812689,
"counterparty_value": {"usd": 43943.88714642392},
"is_screened_address": false,
"contribution_value": {"usd": 63142.383413071},
"indirect_percentage": 14.655433123986867,
"min_number_of_hops": 1,
"indirect_value": {"usd": 19198.496266647082},
"risk_triggers": {"category_id": "0a52f7a2-5da8-4256-b230-d", "category": "Exchange"},
"contribution_percentage": 48.200597505255764,
"entity": "KuCoin"
}
],
"contribution_percentage": 92.25555748324315
}
]
}
],
"evaluationDetailsDestination": [
{
"rule_id": "cf0ca4c8-4783-4d88-8772-424e7a511f0b",
"rule_name": "Exchange_Legal",
"rule_type": "exposure",
"risk_score": 6.919504458834783,
"matched_behaviors": [],
"matched_elements": [
{
"counterparty_percentage": 34.39473797491202,
"counterparty_value": {"usd": 27249.80997933003},
"category_id": "0a52f7a2-5da8-4256-b230-df0da",
"contribution_value": {"usd": 79226.68286993902},
"indirect_percentage": 65.60526202508797,
"indirect_value": {"usd": 51976.87289060898},
"category": "Exchange",
"contribution_percentage": 69.19504458834783,
"contributions": [
{
"counterparty_percentage": 12.3108208,
"counterparty_value": {"usd": 14095.597352678127},
"is_screened_address": false,
"contribution_value": {"usd": 31761.48155214954},
"indirect_percentage": 15.42903968840,
"min_number_of_hops": 1,
"indirect_value": {"usd": 17665.884199471413},
"risk_triggers": {"category_id": "0a52f7a2-5da8-425", "category": "Exchange"},
"contribution_percentage": 27.7398605,
"entity": "Bybit"
}
]
}
]
}
]
}Try it out
Leave empty to use default
Query Parameters
Headers
Documentation
Отчёт по транзакции
Этот метод возвращает упрощённую AML-оценку риска для конкретной транзакции (txHash) в контексте адреса назначения (depositAddress). В ответе присутствуют два поля: completed и passed.
Важно: всегда сначала проверяйте поле completed. Если completed равно false, оценка не считается окончательной, и значение passed никогда не будет true.
HTTP-запрос
Method: GET
URL: /api/v2/compliance/elliptic/tx-report
Пример запроса:
GET /api/v2/compliance/elliptic/tx-report?depositAddress=some_address&txHash=some_tx_hash
Параметры запроса
Все параметры передаются в строке запроса (query string).
Query-параметры
| Parameter | Type | Required | Description |
|---|---|---|---|
| txHash | string | Yes | Хэш транзакции для проверки. |
| depositAddress | string | Yes | Адрес кошелька, на который была отправлена указанная транзакция. |
Примеры
Проверка транзакции / адреса не завершена, результат недоступен
{ "completed": false, "passed": false }
Проверка транзакции / адреса завершена, AML-проверки не пройдены из-за подозрительной активности
{ "completed": true, "passed": false }
Проверка транзакции / адреса завершена, AML-проверки пройдены
{ "completed": true, "passed": true }
Поля ответа
| Field | Type | Description |
|---|---|---|
| completed | boolean | Показывает, завершила ли система комплаенса оценку риска. Если false, результат не считается окончательным. |
| passed | boolean | Показывает, прошли ли транзакция/адрес AML-проверки. Имеет смысл только если completed равно true. |
Code Sample
curl -X GET \
'https://dxspot.io/api/v2/compliance/elliptic/tx-report?txHash=YOUR_TX_HASH&depositAddress=YOUR_DEPOSIT_ADDRESS' \
-H 'accept: application/json' \
-H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
-H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
-H 'X-Api-Signature: {SIGNATURE}'
Response Example
{
"riskScore": 9.22690254307772,
"type": "TRANSACTION",
"evaluationDetails": [
{
"rule_id": "cf0ca4c8-4783-4d88-8772-424e7a511f0b",
"rule_type": "exposure",
"risk_score": 9.22690254307772,
"rule_name": "Exchange_Legal",
"rule_history_id": "15955715-e0bd-4262-83b9-2327a9e9d5b4",
"matched_behaviors": [],
"matched_elements": [
{
"counterparty_percentage": 71.34044036074455,
"counterparty_value": { "usd": 2962.3109641631327 },
"category_id": "0a52f7a2-5da8-4256-b230-df0da6f8449b",
"contribution_value": { "usd": 4152.358675084882 },
"indirect_percentage": 28.659559639255487,
"indirect_value": { "usd": 1190.0477109217506 },
"contributions": [
{
"counterparty_percentage": 33.5451643812689,
"counterparty_value": { "usd": 1509.844579713838 }
}
],
"is_screened_address": false,
"min_number_of_hops": 1,
"risk_triggers": {
"category_id": "0a52f7a2-5da8-4256-b230-d",
"category": "Exchange"
},
"entity": "KuCoin",
"contribution_percentage": 48.200597505255764
}
],
"category": "Exchange",
"contribution_percentage": 92.25555748324315
}
]
}Try it out
Leave empty to use default
Query Parameters
Blockchain transaction hash to be checked.
Destination address where the funds were received (deposit address).