Cette section présente les méthodes permettant d’évaluer les risques liés aux transactions et aux adresses sur la blockchain à l’aide du service Elliptic.
Ces méthodes vous permettent de vérifier la fiabilité des transactions entrantes et sortantes, d’identifier les activités suspectes et de classer les risques.
Vous pouvez également obtenir des rapports détaillés sur les contreparties, leurs parts, les montants et les liens entre les adresses.
Ces informations aident les partenaires à prendre des décisions en matière de conformité et à prévenir la fraude.
Documentation
Rapport AML simplifié
Cette méthode renvoie une évaluation des risques simplifiée pour une adresse blockchain spécifique en utilisant différents services AML.
La réponse contient deux champs : passed et completed.
La clé completed indique si notre système de conformité a terminé l’évaluation des risques — il arrive que les informations reçues des fournisseurs AML soient incomplètes ou insuffisantes pour nos contrôles de risque.
C’est le premier champ que vous devez vérifier — passed ne sera jamais true si completed est false.
À son tour, la clé passed indique si l’adresse fournie a passé nos contrôles de risque.
Une adresse suspecte aura toujours "passed": false dans la réponse de l’API, mais uniquement si completed est défini sur true.
Requête HTTP
Méthode : GET
URL : /api/v2/compliance/elliptic/address-report
Exemple de requête :
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}' \
Paramètres de la requête
Tous les paramètres sont transmis dans la chaîne de requête.
Paramètres de requête
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| address | string | Oui | Adresse de portefeuille à vérifier. |
Exemple de réponse
{ "completed": true, "passed": true }
Champs de la réponse
| Champ | Type | Description |
|---|---|---|
| completed | boolean | Indique si le système de conformité a terminé l’évaluation des risques. Si false, le résultat n’est pas définitif et passed ne pourra jamais être true. |
| passed | boolean | Indique si l’adresse a passé les contrôles de risque. Si l’adresse est suspecte, cette valeur sera false (et n’a de sens que lorsque completed est 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
Rapport de transaction
Cette méthode renvoie une évaluation de risque AML simplifiée pour une transaction spécifique (txHash) dans le contexte d’une adresse de destination (depositAddress).
La réponse contient deux champs : completed et passed.
Important : vérifiez toujours d’abord la valeur de completed.
Si completed est false, l’évaluation n’est pas définitive et passed ne pourra jamais être true.
Requête HTTP
Méthode : GET
URL : /api/v2/compliance/elliptic/tx-report
Exemple de requête :
GET /api/v2/compliance/elliptic/tx-report?depositAddress=some_address&txHash=some_tx_hash
Paramètres de la requête
Tous les paramètres sont transmis dans la chaîne de requête.
Paramètres de requête
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| txHash | string | Oui | Hash de la transaction à vérifier. |
| depositAddress | string | Oui | Adresse de portefeuille qui est la destination de la transaction fournie. |
Exemples
Vérification transaction / adresse incomplète, aucun résultat exploitable
{ "completed": false, "passed": false }
Vérification transaction / adresse complète, contrôles AML non passés en raison d’une activité suspecte
{ "completed": true, "passed": false }
Vérification transaction / adresse complète, contrôles AML passés
{ "completed": true, "passed": true }
Champs de la réponse
| Champ | Type | Description |
|---|---|---|
| completed | boolean | Indique si le système de conformité a terminé l’évaluation des risques. Si false, le résultat n’est pas définitif. |
| passed | boolean | Indique si la transaction / l’adresse a passé les contrôles de risque AML. Ce champ n’est interprétable que lorsque completed est 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).