> 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 el screening de direcciones y monitoreo de transacciones directamente en tus aplicaciones y flujos de trabajo. Ya sea que necesites verificar una sola billetera antes de procesar un retiro o monitorear continuamente transacciones en múltiples cadenas, la API proporciona acceso programático a la misma inteligencia de riesgos disponible en el panel de control de Phalcon Compliance.

## Qué Puedes Hacer

### Address Screening

Verifica direcciones blockchain contra motores de riesgo para identificar entidades sancionadas, exposición a fondos ilícitos y otros riesgos de cumplimiento.

| Endpoint                                                                                                          | Descripción                                                             |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [`POST /address/screen`](/es/api-documentation/address-screening/screen-a-single-address.md)                      | Verifica una sola dirección y obtén resultados de riesgo                |
| [`POST /addresses/screen`](/es/api-documentation/address-screening/batch-screen-addresses.md)                     | Verifica hasta 100 direcciones en una sola solicitud                    |
| [`GET /addresses/details/{chain_id}/{address}`](/es/api-documentation/address-screening/get-an-address-detail.md) | Recupera el desglose detallado de riesgos para una dirección verificada |
| [`GET /addresses/screen/tasks/{task_id}`](/es/api-documentation/address-screening/get-a-task-result.md)           | Consulta los resultados de tareas de screening asincrónicas             |
| [`PUT /addresses/{chain_id}/{address}`](/es/api-documentation/address-screening/update-an-address-info.md)        | Actualiza etiquetas personalizadas o notas en una dirección             |

### Transaction Screening

Monitorea transacciones individuales o lotes para detectar exposición a riesgos en todas las transferencias involucradas.

| Endpoint                                                                                                                         | Descripción                                                              |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`POST /transaction/screen`](/es/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | Verifica una sola transacción                                            |
| [`POST /transactions/screen`](/es/api-documentation/transaction-screening/batch-screen-transactions.md)                          | Verifica hasta 100 transacciones en una sola solicitud                   |
| [`GET /transactions/screen/tasks/{task_id}`](/es/api-documentation/transaction-screening/get-a-task-result.md)                   | Consulta los resultados de tareas de screening asincrónicas              |
| [`GET /transactions/details/{transfer_id}`](/es/api-documentation/transaction-screening/get-a-transfer-detail.md)                | Obtén información detallada de riesgos para una transferencia específica |
| [`GET /transactions/transfers/{chain_id}/{hash}`](/es/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | Lista todas las transferencias dentro de una transacción                 |

### Customer Management

Vincula direcciones y transacciones verificadas a clientes específicos para un seguimiento de cumplimiento organizado.

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

### Blacklist / Whitelist Management

Gestiona listas de direcciones personalizadas para marcar automáticamente u omitir direcciones durante el screening.

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

### Account Management

Consulta el uso de API y cuota de tu proyecto.

| Endpoint                                                                                          | Descripción                            |
| ------------------------------------------------------------------------------------------------- | -------------------------------------- |
| [`GET /account/usage/screening`](/es/api-documentation/account-management/get-screening-usage.md) | Obtén estadísticas de uso de screening |

## Inicio Rápido

**1. Obtén tu clave API** — Ve a **System → API** en el espacio de trabajo de tu proyecto y haz clic en **Generate Key**.

**2. Realiza tu primera solicitud:**

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

**3. Verifica la respuesta** — Si el screening se completa dentro de 10 segundos, obtienes resultados directamente. De lo contrario, recibes un Task ID para consultar mediante `/task/result`.

## Conceptos Clave

* **Risk Engines** — Cada screening se ejecuta contra múltiples motores de riesgo. Los resultados incluyen puntuaciones de riesgo e indicadores de riesgo por motor. Consulta [List of Risk Indicators](/es/api-documentation/introduction/risk-indicator-list.md) para ver todos los indicadores posibles.
* **Async Tasks** — Las solicitudes por lotes y los screenings lentos devuelven un Task ID. Utiliza el endpoint `/task/result` para recuperar resultados cuando estén listos.
* **Chain IDs** — Cada blockchain compatible tiene un ID de cadena numérico (p. ej., Ethereum = `1`, Bitcoin = `-1`). Consulta [Supported Chains](/es/api-documentation/introduction/supported-chains.md) para la lista completa.

## Próximos Pasos

* [Authentication](/es/api-documentation/introduction/authentication.md) — Cómo autenticar tus solicitudes API
* [Rate Limits](/es/api-documentation/introduction/rate-limits.md) — Límites de velocidad predeterminados por endpoint
* [Supported Chains](/es/api-documentation/introduction/supported-chains.md) — Cadenas y sus IDs
* [Changelog](/es/api-documentation/introduction/changelog.md) — Actualizaciones recientes de API