Цей розділ містить методи оцінки ризиків транзакцій та адрес у блокчейні за допомогою сервісу 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://quickex.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://quickex.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://quickex.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).