Crear verificación AML

Crea una nueva verificación AML para una dirección de wallet o un hash de transacción específico. El precio de la verificación se reserva de su saldo cuando la verificación comienza, y la respuesta devuelve la verificación.

POST /v1/aml-checks/new

Solicitud

Parámetros

Campo	Tipo	Requerido	Descripción
type	string	Sí	Tipo de servicio AML: address o hash
network	string	Sí	Código de red blockchain (ver tabla)
address	string	Sí	Dirección válida para la red seleccionada. Para type = hash, es la dirección que participa en la transacción y cuyo lado se analiza (ver direction).
hash	string	Condicional*	Hash de transacción en el formato de la red seleccionada (TRX: 64 caracteres hexadecimales, sin prefijo 0x; Ethereum y las demás redes EVM: 0x y 64 caracteres hexadecimales; el formato de cada red se ve en el ejemplo de la tabla de abajo). Requerido cuando type = hash
direction	string	Condicional**	Qué lado de la transacción se analiza para address: deposit — fondos que llegan a esa dirección, withdrawal — fondos que salen de ella. Requerido cuando type = hash

* Solo para verificaciones de hash.
** Solo para verificaciones de hash. No hay valor predeterminado: una verificación de hash sin un direction válido se rechaza.

Tipos de servicio disponibles

Tipo	Descripción
address	Analiza una dirección y calcula su perfil de riesgo
hash	Analiza una sola transacción desde el lado de una de sus direcciones (deposit o withdrawal)

Redes compatibles

Código	Red	Dirección de ejemplo	Hash de ejemplo
TRX	TRON	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	fd4f300e12040089f624353cdfe7c2ae7ed2378fa65c7e5cce60f69cb1d43bab
BTC	Bitcoin	bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
ETH	Ethereum	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
BSC	BNB Chain	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
SOL	Solana	TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA	5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
TON	TON	EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N	fd4f300e12040089f624353cdfe7c2ae7ed2378fa65c7e5cce60f69cb1d43bab
MATIC	Polygon	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
ARB	Arbitrum	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
BASE	Base	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
OP	Optimism	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
AVAX	Avalanche C-Chain	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
LTC	Litecoin	LQTpS3VaYTjCr4s9Y1t5zbeY26zevf7Fb3	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
XRP	Ripple	rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh	E3FE6EA3D48F0C2B639448020EA4F03D4F4F8FFDB243A852A0F59177921B4879
ALGO	Algorand	VCMJKWOY5P5P7SKMZFFOCEROPJCZOTIJMNIYNUCKH7LRO45JMJP6UYBIJA	UITN53MFMO6QHK6GCAUMF5MXBJG4OB6S3VCHTGFY5PQGHNWJ5NWQ
APT	Aptos	0x0000000000000000000000000000000000000000000000000000000000000001	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
BCH	Bitcoin Cash	bitcoincash:qpm2qsznhks23z7629mms6s4cwef74vcwvy22gdx6a	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
BSV	Bitcoin SV	1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
ADA	Cardano	addr1qx2fxv2umyhttkxyxp8x0dlpdt3k6cwng5pxj3jhsydzer3n0d3vllmyqwsx5wktcd8cc3sq835lu7drv2xwl2wywfgse35a3x	8a5a6f0e9c5d7c4e1b62ef2b36d03b34f2b0b6f9f6c7e7a3d55b0f5c8a3b2c1d
CELO	Celo	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
DOGE	Dogecoin	DH5yaieqoZN36fDVciNyRueRGvGLR3mr7L	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
ETC	Ethereum Classic	0x742d35Cc6634C0532925a3b844Bc454e4438f44e	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
NEAR	NEAR	alice.near	6zgh2u9DqHHiXzdy9ouTP7oGky2T4nugqzqt9wJZwNFm
DOT	Polkadot	15oF4uVJwmo4TdGW7VfQxNLavjCXviqxT9S1MgbjMNHr6Sp5	0x0f61ba2c923f4113a91eec9a9ce6145866e18b91dab5d2899dbe586a1847652b
XLM	Stellar	GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7	3389e9f0f1a65f19736cacf544c2e825313e8447f569233bb8db39aa607c8889
TetherOMNI	Tether (Omni)	1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
XTZ	Tezos	tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb	onvsLP3JFZia2mzZKWaFuFkWg2L5p3BDUhzh5Kr6CiDDN3rtQ1D
ZEC	Zcash	t1Rv4exT7bqhZqi2j7xz8bUHDMxwosrjADU	4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b

TIP

Se analizan todas las redes de esta lista, al mismo precio por verificación sea cual sea la red. network no distingue mayúsculas de minúsculas (btc es BTC); address y hash se comprueban con el formato de la red seleccionada. Un tipo de verificación que no está a la venta para su proyecto (ver Obtener servicios AML), o una red que el servicio de análisis no puede atender en este momento, se responde con el código 35 y no se cobra nada.

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "type": "address",
  "network": "TRX",
  "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D"
}'

# Calcular firma
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Realizar solicitud a la API
curl -X POST "https://api.trxup.com/v1/aml-checks/new" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  type: 'address',
  network: 'TRX',
  address: 'TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D'
});

// Calcular firma
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Realizar solicitud a la API
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/aml-checks/new',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'type' => 'address',
  'network' => 'TRX',
  'address' => 'TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D',
], JSON_UNESCAPED_SLASHES);

// Calcular firma
$signature = hash('sha256', $requestBody . $apiSecret);

// Realizar solicitud a la API
$ch = curl_init('https://api.trxup.com/v1/aml-checks/new');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'type': 'address',
  'network': 'TRX',
  'address': 'TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D'
})

# Calcular firma
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Realizar solicitud a la API
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/aml-checks/new',
  headers=headers,
  data=request_body
)

print(response.json())

Ejemplo de solicitud para hash

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "type": "hash",
  "network": "TRX",
  "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
  "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
  "direction": "withdrawal"
}'

# Calcular firma
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Realizar solicitud a la API
curl -X POST "https://api.trxup.com/v1/aml-checks/new" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  type: 'hash',
  network: 'TRX',
  address: 'TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D',
  hash: 'E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2',
  direction: 'withdrawal'
});

// Calcular firma
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Realizar solicitud a la API
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/aml-checks/new',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'type' => 'hash',
  'network' => 'TRX',
  'address' => 'TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D',
  'hash' => 'E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2',
  'direction' => 'withdrawal'
], JSON_UNESCAPED_SLASHES);

// Calcular firma
$signature = hash('sha256', $requestBody . $apiSecret);

// Realizar solicitud a la API
$ch = curl_init('https://api.trxup.com/v1/aml-checks/new');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'type': 'hash',
  'network': 'TRX',
  'address': 'TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D',
  'hash': 'E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2',
  'direction': 'withdrawal'
})

# Calcular firma
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Realizar solicitud a la API
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/aml-checks/new',
  headers=headers,
  data=request_body
)

print(response.json())

Respuesta

La respuesta devuelve la verificación AML. Si el resultado aún se está completando, el estado es pending: consulte Consultar estado AML con el id devuelto hasta que cambie.

Campos de la respuesta

Campo	Tipo	Descripción
code	integer	Código de respuesta (0 = éxito)
request_id	string	Identificador único de la solicitud
result	object	Datos de la verificación AML
result.id	string	Identificador de la verificación AML
result.type	string	Tipo de servicio AML (address o hash)
result.address	string	Dirección analizada
result.network	string	Código de red blockchain tal como figura en la lista de redes compatibles (p. ej. TRX, TetherOMNI)
result.status	string	Estado de la verificación (pending, processing, completed, failed, expired, skipped)
result.risk_score	string|null	Puntaje de riesgo como cadena con dos decimales (p. ej. "12.50"), o null si aún no hay puntaje
result.risk_level	string|null	Nivel de riesgo textual (low, medium, high)
result.blacklist	boolean	true si existe coincidencia con listas negras
result.risk_factors	array	Categorías de riesgo con las que están vinculados los fondos, ordenadas de mayor a menor score, una entrada por categoría; [] vacío si no se informó ninguna categoría (por ejemplo, mientras la verificación no se ha completado)
result.risk_factors[].name	string	Clave de la categoría, una de las indicadas en Categorías de factores de riesgo; una categoría fuera de esa lista se informa como other
result.risk_factors[].label	string	Nombre de la categoría en inglés (no se traduce)
result.risk_factors[].group	string	Grupo de riesgo de la categoría: low, medium o high
result.risk_factors[].score	number	Proporción de los fondos vinculada a esta categoría, de 0 a 1, redondeada a 3 decimales
result.checked_at	string	Marca temporal de creación de la verificación (ISO 8601)
result.hash	string	Hash de transacción analizado (solo verificaciones de hash)
result.direction	string	Lado de la transacción analizado, deposit o withdrawal (solo verificaciones de hash)

La lista completa de claves de categoría, con sus nombres y grupos, está en Categorías de factores de riesgo.

Ejemplo de respuesta

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "1041",
    "type": "address",
    "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
    "network": "TRX",
    "status": "completed",
    "risk_score": "12.50",
    "risk_level": "medium",
    "blacklist": false,
    "risk_factors": [
      {
        "name": "exchange",
        "label": "Exchange",
        "group": "low",
        "score": 0.9
      },
      {
        "name": "p2p_exchange_mlrisk_high",
        "label": "P2P Exchange (High Risk)",
        "group": "medium",
        "score": 0.1
      }
    ],
    "checked_at": "2024-03-25T10:40:05+00:00"
  }
}

Para una verificación de hash, hash y direction siguen a checked_at:

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "1042",
    "type": "hash",
    "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
    "network": "TRX",
    "status": "pending",
    "risk_score": null,
    "risk_level": null,
    "blacklist": false,
    "risk_factors": [],
    "checked_at": "2024-03-25T10:42:12+00:00",
    "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
    "direction": "withdrawal"
  }
}

Cargos y solicitudes repetidas

• El precio de la verificación se reserva cuando la verificación comienza. Si la verificación no puede ejecutarse — los datos de entrada se rechazan o el error es de nuestro lado — la reserva se devuelve íntegramente.
• En una verificación de hash, si address no participa en la transacción, la verificación se rechaza con el código 2 (The address was not found in this transaction) y no se cobra nada.
• En una verificación de dirección, si el servicio de verificación rechaza comprobar la dirección, la verificación se rechaza con el código 2 (The screening service could not check this address; nothing was charged, clave invalid_service_or_params, sin detalle) y no se cobra nada. Revise la dirección e inténtelo de nuevo más tarde.
• Repetir la misma consulta en el plazo de una hora — el mismo type, network y address, y en verificaciones de hash también el mismo hash y direction — devuelve la verificación anterior sin cobrar nada.
• Una segunda solicitud idéntica enviada mientras la primera aún está en curso se rechaza con HTTP 503 (temporarily_unavailable) y no se cobra nada. Vuelva a intentarlo en un momento.

Posibles errores

Código de error	Key	Descripción
1	auth	Error de autenticación (token o firma incorrectos)
2	invalid_service_or_params	Parámetros inválidos, comprobados en este orden: type; network (Unsupported network); address (Invalid address provided); en verificaciones de hash, hash (Hash is required for hash checks) y direction (Invalid direction value); en una verificación de hash cuya address no participa en la transacción, The address was not found in this transaction (clave invalid_service_or_params.hash), no se cobra nada; en una verificación de dirección que el servicio de verificación rechazó, The screening service could not check this address; nothing was charged (clave invalid_service_or_params), no se cobra nada
5	wallet_not_found	Billetera no encontrada
6	insufficient_funds	Fondos insuficientes para ejecutar la verificación
35	service_unavailable	Este tipo de verificación o esta red no está disponible para su proyecto (por ejemplo, un tipo de verificación que no está a la venta para su proyecto); no se cobra nada
500	internal_server_error	Error interno del servidor
503	temporarily_unavailable	Una verificación idéntica sigue en curso (HTTP 503); no se cobró nada, vuelva a intentarlo en un momento