Esta secção contém métodos para avaliar o risco de transações e endereços na blockchain utilizando o serviço Elliptic.
Os métodos permitem verificar a fiabilidade das transações recebidas e enviadas, identificar atividades suspeitas e categorizar riscos.
Também é possível obter relatórios detalhados sobre contrapartes, as suas participações, montantes e ligações entre endereços.
Essas informações ajudam os parceiros a tomar decisões de conformidade e a prevenir fraudes.
Documentation
Relatório AML simplificado
Este método retorna uma avaliação de risco simplificada para um endereço específico de blockchain utilizando vários serviços de AML.
A resposta inclui dois campos: passed e completed.
A chave completed indica se o nosso sistema de compliance concluiu a avaliação de risco — às vezes, as informações recebidas dos provedores de AML podem ser incompletas ou insuficientes para os nossos verificadores de risco.
Esta é a primeira chave que você deve verificar — passed nunca será true se completed for false.
Por sua vez, a chave passed indica se o endereço fornecido foi aprovado nas nossas verificações de risco.
Um endereço suspeito terá sempre "passed": false na resposta da API, mas apenas se completed estiver definido como true.
HTTP Request
Método: GET
URL: /api/v2/compliance/elliptic/address-report
Exemplo de requisição:
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}' \
Parâmetros da requisição
Todos os parâmetros são enviados na query string.
Query Parameters
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| address | string | Sim | Endereço de carteira a ser verificado. |
Exemplo de resposta
{ "completed": true, "passed": true }
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
| completed | boolean | Indica se o sistema de compliance concluiu a avaliação de risco. Se false, o resultado não é definitivo e passed nunca será true. |
| passed | boolean | Indica se o endereço foi aprovado nas verificações de risco. Se o endereço for suspeito, este valor será false (só é relevante quando 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
Relatório de transação
Este método retorna uma avaliação de risco AML simplificada para uma transação específica (txHash) no contexto de um endereço de destino (depositAddress).
A resposta inclui dois campos: completed e passed.
Importante: verifique sempre completed primeiro. Se completed for false, a avaliação não é definitiva e passed nunca será true.
HTTP Request
Método: GET
URL: /api/v2/compliance/elliptic/tx-report
Exemplo de requisição:
GET /api/v2/compliance/elliptic/tx-report?depositAddress=some_address&txHash=some_tx_hash
Parâmetros da requisição
Todos os parâmetros são enviados na query string.
Query Parameters
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| txHash | string | Sim | Hash da transação a ser verificada. |
| depositAddress | string | Sim | Endereço de carteira que foi o destino da transação fornecida. |
Exemplos
Verificação de transação / endereço incompleta, nenhum resultado pode ser obtido
{ "completed": false, "passed": false }
Verificação de transação / endereço concluída, verificações AML não aprovadas devido a atividade suspeita
{ "completed": true, "passed": false }
Verificação de transação / endereço concluída, verificações AML aprovadas
{ "completed": true, "passed": true }
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
| completed | boolean |
Indica se o sistema de compliance concluiu a avaliação de risco. Se false, o resultado não é definitivo.
|
| passed | boolean |
Indica se a transação/endereço foi aprovado nas verificações de risco AML. Só é relevante quando 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).