> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction.md).

# Introducción

La API REST de Phalcon Compliance te permite integrar la evaluación de direcciones y el monitoreo de transacciones directamente en tus aplicaciones y flujos de trabajo. Tanto si necesitas comprobar una wallet individual antes de procesar un retiro como si quieres monitorear continuamente transacciones en varias cadenas, la API proporciona acceso programático a la misma inteligencia de riesgos disponible en el panel de Phalcon Compliance.

## Qué puedes hacer

### Evaluación de direcciones

Evalúa direcciones de blockchain con el motor de riesgos para identificar entidades sancionadas, exposición a fondos ilícitos y otros riesgos de cumplimiento.

| Endpoint                                                                                                                                                      | Descripción                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [`POST /address/screen`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/screen-a-single-address.md)                      | Evalúa una dirección individual y obtiene los resultados de riesgo  |
| [`POST /addresses/screen`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/batch-screen-addresses.md)                     | Evalúa hasta 100 direcciones en una solicitud                       |
| [`GET /addresses/details/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/get-an-address-detail.md) | Recupera un desglose detallado del riesgo de una dirección evaluada |
| [`GET /addresses/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/get-a-task-result.md)           | Consulta los resultados de una tarea de evaluación asíncrona        |
| [`PUT /addresses/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/address-screening/update-an-address-info.md)        | Actualiza etiquetas personalizadas o notas de una dirección         |

### Evaluación de transacciones

Monitorea la exposición al riesgo de una transacción individual o de un lote de transacciones, incluidas todas las transferencias asociadas.

| Endpoint                                                                                                                                                                     | Descripción                                                                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [`POST /transaction/screen`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | Evalúa una transacción individual                                             |
| [`POST /transactions/screen`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/transaction-screening/batch-screen-transactions.md)                          | Evalúa hasta 100 transacciones en una solicitud                               |
| [`GET /transactions/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/transaction-screening/get-a-task-result.md)                   | Consulta los resultados de una tarea de evaluación asíncrona                  |
| [`GET /transactions/details/{transfer_id}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/transaction-screening/get-a-transfer-detail.md)                | Obtiene información detallada sobre el riesgo de una transferencia específica |
| [`GET /transactions/transfers/{chain_id}/{hash}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | Enumera todas las transferencias de una transacción                           |

### Gestión de clientes

Vincula direcciones y transacciones evaluadas con clientes específicos para organizar el seguimiento del cumplimiento.

| Endpoint                                                                                                                                                     | Descripción                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| [`GET /customers/details/{customer_id}`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/customer/get-a-customer-detail.md)                | Obtiene los detalles de un cliente específico |
| [`POST /customers/{customer_id}/addresses`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/customer/add-addresses-to-a-customer.md)       | Añade direcciones a un cliente                |
| [`POST /customers/{customer_id}/transactions`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/customer/add-transactions-to-a-customer.md) | Añade transacciones a un cliente              |

### Gestión de listas negras y listas blancas

Administra listas de direcciones personalizadas para marcarlas automáticamente o excluirlas durante la evaluación.

| Endpoint                                                                                                                                                         | Descripción                            |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| [`POST /blacklists/add`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | Añade direcciones a la lista negra     |
| [`POST /blacklists/remove`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | Elimina direcciones de la lista negra  |
| [`POST /whitelists/add`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | Añade direcciones a la lista blanca    |
| [`POST /whitelists/remove`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | Elimina direcciones de la lista blanca |

### Gestión de cuentas

Consulta el uso y la cuota de API de tu proyecto.

| Endpoint                                                                                                                                      | Descripción                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| [`GET /account/usage/screening`](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/account-management/get-screening-usage.md) | Obtiene estadísticas de uso de la evaluación |

## Inicio rápido

**1. Obtén tu API key** — En el espacio de trabajo de tu proyecto, ve a **System → API** y haz clic en **Generate Key**.

**2. Envía tu primera solicitud:**

```bash
curl -X POST {BASE_URL}/address/screen \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "chainId": 1,
    "address": "0x..."
  }'
```

**3. Comprueba la respuesta** — Si la evaluación se completa en 10 segundos, recibirás el resultado directamente. De lo contrario, recibirás un Task ID que podrás consultar mediante `/addresses/screen/tasks/{task_id}` (o mediante `/transactions/screen/tasks/{task_id}` para la evaluación de transacciones).

## Conceptos clave

* **Motores de riesgo** — Cada evaluación se ejecuta en varios motores de riesgo. Los resultados incluyen la puntuación de riesgo y los indicadores de riesgo de cada motor. Consulta la [Lista de indicadores de riesgo](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction/risk-indicator-list.md) para ver todos los indicadores posibles.
* **Tareas asíncronas** — Las solicitudes por lotes y las evaluaciones lentas devuelven un Task ID. Cuando los resultados estén listos, recupéralos mediante `/addresses/screen/tasks/{task_id}` o `/transactions/screen/tasks/{task_id}`.
* **Chain ID** — Cada blockchain compatible tiene un ID de cadena numérico (por ejemplo, Ethereum = `1`, Bitcoin = `-1`). Consulta [Cadenas compatibles](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction/supported-chains.md) para ver la lista completa.

## Próximos pasos

* [Autenticación](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction/authentication.md) — Cómo autenticar tus solicitudes de API
* [Límites de solicitudes](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction/rate-limits.md) — Límites de solicitudes predeterminados para cada endpoint
* [Cadenas compatibles](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction/supported-chains.md) — Cadenas y sus ID
* [Registro de cambios](https://docs.compliance.phalcon.blocksec.com/es/api-documentation/introduction/changelog.md) — Actualizaciones recientes de la API
