این بخش شامل روش هایی برای ارزیابی ریسک معاملات و آدرس ها در بلاک چین با استفاده از سرویس بیضوی است. این روش ها به شما امکان می دهد قابلیت اطمینان معاملات ورودی و خروجی را بررسی کنید ، فعالیت های مشکوک را شناسایی کرده و خطرات را دسته بندی کنید. همچنین می توانید گزارش های مفصل در مورد طرفین ، سهام ، مبالغ و ارتباطات بین آدرس ها را دریافت کنید. این اطلاعات به شرکا کمک می کند تا تصمیمات انطباق را اتخاذ کنند ، از تقلب جلوگیری کنند.
Documentation
گزارش سادهشده AML
این متد یک ارزیابی سادهشده از ریسک برای یک آدرس مشخص بلاکچین با استفاده از سرویسهای مختلف AML برمیگرداند. پاسخ شامل دو فیلد است: passed و completed.
کلید completed نشان میدهد که آیا سیستم کامپلاینس ما ارزیابی ریسک را بهطور کامل به پایان رسانده است یا خیر — گاهی اطلاعاتی که از ارائهدهندگان AML دریافت میشود میتواند ناقص یا برای چکهای ریسک ما ناکافی باشد. این اولین کلیدی است که باید بررسی کنید — مقدار passed هرگز true نخواهد بود اگر completed برابر با false باشد.
به نوبه خود، کلید passed نشان میدهد آیا آدرس ارائهشده، چکهای ریسک ما را با موفقیت گذرانده است یا نه. یک آدرس مشکوک همیشه در پاسخ API مقدار "passed": false خواهد داشت، اما فقط در صورتی که مقدار 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
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
| address | string | بله | آدرس کیف پولی که باید بررسی شود. |
نمونه پاسخ
{ "completed": true, "passed": true }
فیلدهای پاسخ
| فیلد | نوع | توضیحات |
|---|---|---|
| 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
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
| txHash | string | بله | هش تراکنشی که باید بررسی شود. |
| depositAddress | string | بله | آدرس کیف پولی که مقصد تراکنشِ ارائهشده بوده است. |
نمونهها
بررسی تراکنش / آدرس تکمیل نشده است، هیچ نتیجهای قابل بهدستآوردن نیست
{ "completed": false, "passed": false }
بررسی تراکنش / آدرس کامل شده است، چکهای AML بهدلیل فعالیت مشکوک رد شدهاند
{ "completed": true, "passed": false }
بررسی تراکنش / آدرس کامل شده است، چکهای AML با موفقیت گذرانده شدهاند
{ "completed": true, "passed": true }
فیلدهای پاسخ
| فیلد | نوع | توضیحات |
|---|---|---|
| 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).