Отчеты о рисках Elliptic

Команда Quickex

18 декабря 2025 г.

~1 мин. чтения

В этом разделе представлены методы оценки рисков транзакций и адресов в блокчейне с помощью сервиса Elliptic.

Методы позволяют проверять надежность входящих и исходящих транзакций, выявлять подозрительную активность и классифицировать риски.

Также можно получить подробные отчеты о контрагентах, их долях, суммах и связях между адресами.

Эта информация помогает партнерам принимать решения по комплаенсу, предотвращать мошенничество.

GET

compliance/elliptic/address-report

Endpoint URL

https://quickex.io/api/v2/compliance/elliptic/address-report

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

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

GET

compliance/elliptic/tx-report

Endpoint URL

https://quickex.io/api/v2/compliance/elliptic/tx-report

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

Response Example

Try it out

Поделиться статьей:

Отчеты о рисках Elliptic

Documentation

Упрощенный AML-отчет

HTTP-запрос

Пример запроса:

Параметры запроса

Query-параметры

Пример ответа

Поля ответа

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

Отчёт по транзакции

HTTP-запрос

Пример запроса:

Параметры запроса

Query-параметры

Примеры

Проверка транзакции / адреса не завершена, результат недоступен

Проверка транзакции / адреса завершена, AML-проверки не пройдены из-за подозрительной активности

Проверка транзакции / адреса завершена, AML-проверки пройдены

Поля ответа

Code Sample

Response Example

Try it out

Query Parameters

Headers