Esta sección contiene métodos para evaluar el riesgo de transacciones y direcciones en la cadena de bloques utilizando el servicio Elliptic.
Los métodos permiten comprobar la fiabilidad de las transacciones entrantes y salientes, identificar actividades sospechosas y categorizar los riesgos.
También puedes obtener informes detallados sobre las contrapartes, sus participaciones, los importes y las conexiones entre direcciones.
Esta información ayuda a los socios a tomar decisiones de cumplimiento normativo (compliance) y a prevenir el fraude.
Documentation
Informe AML simplificado
Este método devuelve una evaluación de riesgo simplificada para una dirección específica de blockchain utilizando varios servicios AML.
La respuesta incluye dos campos: passed y completed.
La clave completed indica si nuestro sistema de cumplimiento ha completado la evaluación de riesgos; en ocasiones, la información recibida de los proveedores AML puede ser incompleta o insuficiente para nuestras comprobaciones de riesgo. Esta es la primera clave que debes comprobar: passed nunca será true si completed es false.
A su vez, la clave passed indica si la dirección proporcionada ha superado nuestras comprobaciones de riesgo. Una dirección sospechosa siempre tendrá "passed": false en la respuesta de la API, pero solo si completed está establecido en true.
Solicitud HTTP
Método: GET
URL: /api/v2/compliance/elliptic/address-report
Ejemplo de solicitud:
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 de la solicitud
Todos los parámetros se pasan en la cadena de consulta (query string).
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| address | string | Sí | Dirección de monedero que se va a comprobar. |
Ejemplo de respuesta
{ "completed": true, "passed": true }
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| completed | boolean | Indica si el sistema de cumplimiento ha completado la evaluación de riesgos. Si es false, el resultado no es definitivo y passed nunca será true. |
| passed | boolean | Indica si la dirección ha superado las comprobaciones de riesgo. Si la dirección es sospechosa, este valor será false (solo tiene sentido cuando completed es 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
Informe de transacción
Este método devuelve una evaluación de riesgo AML simplificada para una transacción específica (txHash) en el contexto de una dirección de destino (depositAddress).
La respuesta incluye dos campos: completed y passed.
Importante: comprueba siempre primero completed. Si completed es false, la evaluación no es definitiva y passed nunca será true.
Solicitud HTTP
Método: GET
URL: /api/v2/compliance/elliptic/tx-report
Ejemplo de solicitud:
GET /api/v2/compliance/elliptic/tx-report?depositAddress=some_address&txHash=some_tx_hash
Parámetros de la solicitud
Todos los parámetros se pasan en la cadena de consulta (query string).
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| txHash | string | Sí | Hash de la transacción que se va a comprobar. |
| depositAddress | string | Sí | Dirección de monedero que fue el destino de la transacción proporcionada. |
Ejemplos
Verificación de transacción / dirección incompleta, no se pueden obtener resultados
{ "completed": false, "passed": false }
Verificación de transacción / dirección completa, comprobaciones AML no superadas por actividad sospechosa
{ "completed": true, "passed": false }
Verificación de transacción / dirección completa, comprobaciones AML superadas
{ "completed": true, "passed": true }
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| completed | boolean | Indica si el sistema de cumplimiento ha completado la evaluación de riesgos. Si false, el resultado no es definitivo. |
| passed | boolean | Indica si la transacción/dirección ha superado las comprobaciones de riesgo AML. Solo es significativo cuando completed es 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).