Dieser Abschnitt enthält Methoden zur Bewertung des Risikos von Transaktionen und Adressen in der Blockchain unter Verwendung des Elliptic-Dienstes.
Mit diesen Methoden können Sie die Zuverlässigkeit eingehender und ausgehender Transaktionen überprüfen, verdächtige Aktivitäten identifizieren und Risiken kategorisieren.
Außerdem können Sie detaillierte Berichte über Gegenparteien, deren Anteile, Beträge und Verbindungen zwischen Adressen erhalten.
Diese Informationen helfen Partnern, Compliance-Entscheidungen zu treffen und Betrug zu verhindern.
Documentation
Vereinfachter AML-Bericht
Diese Methode liefert eine vereinfachte Risikobewertung für eine bestimmte Blockchain-Adresse mithilfe verschiedener AML-Dienste.
Die Antwort enthält zwei Felder: passed und completed.
Der Schlüssel completed gibt an, ob unser Compliance-System die Risikobewertung vollständig abgeschlossen hat – manchmal können die von AML-Anbietern gelieferten Informationen unvollständig oder für unsere Risikoprüfer unzureichend sein. Dies ist der erste Schlüssel, den Sie prüfen sollten – passed wird niemals true sein, wenn completed false ist.
Der Schlüssel passed gibt wiederum an, ob die angegebene Adresse unsere Risikoprüfungen bestanden hat. Eine verdächtige Adresse wird in der API-Antwort immer "passed": false haben, jedoch nur, wenn completed auf true gesetzt ist.
HTTP-Anfrage
Methode: GET
URL: /api/v2/compliance/elliptic/address-report
Anfragebeispiel:
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}' \
Anfrageparameter
Alle Parameter werden in der Query-String übergeben.
Query-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| address | string | Ja | Zu prüfende Wallet-Adresse. |
Beispielantwort
{ "completed": true, "passed": true }
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
| completed | boolean | Gibt an, ob das Compliance-System die Risikobewertung abgeschlossen hat. Ist false, ist das Ergebnis nicht endgültig und passed kann niemals true sein. |
| passed | boolean | Gibt an, ob die Adresse die Risikoprüfungen bestanden hat. Ist die Adresse verdächtig, lautet dieser Wert false (aussagekräftig nur, wenn completed true ist). |
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
Transaktionsbericht
Diese Methode liefert eine vereinfachte AML-Risikobewertung für eine bestimmte Transaktion (txHash) im Kontext einer Zieladresse (depositAddress).
Die Antwort enthält zwei Felder: completed und passed.
Wichtig: Prüfen Sie immer zuerst completed.
Wenn completed false ist, ist die Bewertung nicht endgültig und passed kann niemals true sein.
HTTP-Anfrage
Methode: GET
URL: /api/v2/compliance/elliptic/tx-report
Anfragebeispiel:
GET /api/v2/compliance/elliptic/tx-report?depositAddress=some_address&txHash=some_tx_hash
Anfrageparameter
Alle Parameter werden im Query-String übergeben.
Query-Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| txHash | string | Ja | Zu prüfender Transaktions-Hash. |
| depositAddress | string | Ja | Wallet-Adresse, die das Ziel der angegebenen Transaktion war. |
Beispiele
Transaktions-/Adressprüfung nicht abgeschlossen, keine Ergebnisse verfügbar
{ "completed": false, "passed": false }
Transaktions-/Adressprüfung abgeschlossen, AML-Prüfung aufgrund verdächtiger Aktivität nicht bestanden
{ "completed": true, "passed": false }
Transaktions-/Adressprüfung abgeschlossen, AML-Prüfung bestanden
{ "completed": true, "passed": true }
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
| completed | boolean |
Gibt an, ob das Compliance-System die Risikobewertung abgeschlossen hat. Wenn false, ist das Ergebnis nicht endgültig.
|
| passed | boolean |
Gibt an, ob die Transaktion/Adresse die AML-Risikoprüfung bestanden hat. Sinnvoll nur, wenn completed true ist.
|
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).