Pool de Liquidez

En pocas palabras
El Pool de Liquidez de Blockradar permite a los Proveedores de Liquidez (LPs) aprobados definir y gestionar tasas de cambio para pares de activos. Las tasas impulsan el motor de intercambio interno — cuando un usuario inicia un intercambio, el sistema selecciona automáticamente la mejor tasa disponible de los LPs activos, valida la liquidez y ejecuta la transacción.

Tasas del Pool de Liquidez de Blockradar

Requisitos Previos

Antes de utilizar la API del Pool de Liquidez, asegúrese de tener:

Convertirse en Proveedor de Liquidez

El Pool de Liquidez está disponible únicamente para Proveedores de Liquidez aprobados. Para comenzar, complete el formulario de solicitud de LP y el equipo de Blockradar revisará su solicitud y lo incorporará.

Clave API

Una vez incorporado, genere una clave API desde el Panel de Blockradar. Navegue a Developers para crear una.

Financie sus Billeteras

Asegúrese de que sus billeteras de tesorería tengan saldo suficiente de los activos para los que planea proporcionar liquidez, además de tokens nativos para cubrir las tarifas de red.

Cómo Funciona

Como Proveedor de Liquidez, usted define tasas de cambio para pares de activos (por ejemplo, BNB → USDC). Cuando un usuario en la plataforma Blockradar inicia un intercambio, el sistema:

Encuentra tasas coincidentes de todos los LPs activos para el par de activos solicitado.
Clasifica candidatos por mejor tasa, prioridad del LP y tiempo de creación.
Valida la liquidez verificando que la billetera de tesorería del LP seleccionado tenga saldo suficiente para completar el intercambio.
Ejecuta el intercambio utilizando la tasa y la tesorería del LP seleccionado.

Gestión de Tasas

Cree, actualice, desactive y reactive tasas de cambio para cualquier par de activos compatible.

Bandas de Monto

Defina montos mínimos y máximos de transacción por tasa para controlar la exposición y segmentar niveles de precios.

Historial de Versiones

Cada cambio de tasa crea una nueva versión. El historial completo se preserva para auditoría y análisis.

Selección Automática

El sistema selecciona automáticamente el mejor LP para cada intercambio basándose en la tasa, prioridad y liquidez disponible.

Ciclo de Vida de las Tasas

Las tasas siguen un ciclo de vida claro con seguimiento completo de versiones:

1. Crear una Tasa

Defina una nueva tasa de cambio para un par de activos. La tasa comienza como active en la versión 1.

curl --request POST \
  --url https://api.blockradar.co/v1/rates \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "fromAsset": "BNB",
    "toAsset": "USDC",
    "rate": "605.50",
    "minAmount": "0.01",
    "maxAmount": "100"
  }'

Parámetros de Solicitud

Parámetro	Tipo	Requerido	Descripción
`fromAsset`	string	Sí	El símbolo del activo de origen (por ejemplo, `BNB`)
`toAsset`	string	Sí	El símbolo del activo de destino (por ejemplo, `USDC`)
`rate`	string	Sí	La tasa de cambio. Se proporciona como cadena de texto para evitar problemas de precisión de punto flotante
`minAmount`	string	Sí	Monto mínimo de transacción para esta tasa (inclusivo)
`maxAmount`	string	No	Monto máximo de transacción (exclusivo). Omita para ilimitado

Respuesta de Creación

{
  "message": "Rate created successfully",
  "statusCode": 201,
  "data": {
    "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
    "fromAsset": "BNB",
    "toAsset": "USDC",
    "rate": "605.50",
    "minAmount": "0.01",
    "maxAmount": "100",
    "isActive": true,
    "status": "active",
    "version": 1,
    "network": "testnet",
    "createdAt": "2026-02-19T07:50:17.042Z"
  }
}

2. Actualizar una Tasa

Modifique la tasa o las restricciones de monto para una tasa activa existente. Esto crea una nueva versión — la versión anterior se marca automáticamente como superseded.

curl --request PATCH \
  --url https://api.blockradar.co/v1/rates/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "rate": "610.00",
    "minAmount": "0.005"
  }'

Solo proporcione los campos que desea cambiar — se admiten actualizaciones parciales.

3. Desactivar una Tasa

Retire temporalmente una tasa de servicio. La tasa se convierte en deactivated y ya no será seleccionada para intercambios.

curl --request POST \
  --url https://api.blockradar.co/v1/rates/{id}/deactivate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "reason": "Pausing for maintenance"
  }'

4. Reactivar una Tasa

Vuelva a poner en servicio una tasa desactivada. Esto crea una nueva versión con estado active.

curl --request POST \
  --url https://api.blockradar.co/v1/rates/{id}/reactivate \
  --header 'x-api-key: <api-key>'

Versionado de Tasas

Cada vez que se actualiza o reactiva una tasa, se crea una nueva versión. La versión anterior se marca como superseded. Esto proporciona un registro de auditoría completo.

Campo	Descripción
`version`	Número de versión secuencial que comienza en 1
`rootRateId`	Apunta a la tasa original — todas las versiones en una cadena comparten este ID
`previousRateId`	Apunta a la versión inmediatamente anterior

Ejemplo de Cadena de Versiones

v1 (active)  →  v2 (active, v1 superseded)  →  v3 (deactivated)  →  v4 (active, v3 superseded)

Ver Historial de Tasas

Recupere el historial completo de versiones de una tasa:

curl --request GET \
  --url https://api.blockradar.co/v1/rates/{id}/history \
  --header 'x-api-key: <api-key>'

Respuesta del Historial

{
  "message": "Rate history retrieved successfully",
  "statusCode": 200,
  "data": {
    "currentVersion": 2,
    "rootRateId": "d69078ef-2467-40f4-bb00-63394efe32c0",
    "history": [
      {
        "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
        "fromAsset": "BNB",
        "toAsset": "USDC",
        "rate": "605.50",
        "minAmount": "0.01",
        "status": "superseded",
        "version": 1,
        "createdAt": "2026-02-19T07:50:17.042Z"
      },
      {
        "id": "cad01df3-4041-4e81-a368-534fb4de5d12",
        "fromAsset": "BNB",
        "toAsset": "USDC",
        "rate": "610.00",
        "minAmount": "0.005",
        "status": "active",
        "version": 2,
        "createdAt": "2026-02-19T07:59:35.481Z"
      }
    ]
  },
  "meta": {
    "currentPage": 1,
    "itemCount": 2,
    "itemsPerPage": 10,
    "totalItems": 2,
    "totalPages": 1
  }
}

Estados de las Tasas

Estado	Descripción
`active`	Actualmente activo y elegible para selección de intercambio
`superseded`	Reemplazado por una versión más reciente (mediante actualización o reactivación)
`deactivated`	Retirado manualmente del servicio — puede ser reactivado

superseded es un estado terminal — estos registros son históricos y no pueden ser modificados.

Bandas de Monto

Cada tasa cubre un rango de monto de transacción definido por minAmount y maxAmount:

minAmount — El límite inferior inclusivo. Las transacciones por debajo de este monto no utilizarán esta tasa.
maxAmount — El límite superior exclusivo. Establezca en null (omita) para ilimitado.

Múltiples Tasas para el Mismo Par

Puede crear múltiples tasas para el mismo par de activos con diferentes bandas de monto para ofrecer precios escalonados:

Tasa	Banda	Caso de Uso
605.00	0.01 – 10 BNB	Transacciones pequeñas
606.50	10 – 100 BNB	Transacciones medianas
608.00	100+ BNB	Transacciones grandes

Las bandas de monto para el mismo par de activos no deben superponerse. El sistema rechazará una tasa si su banda se superpone con otra tasa activa para el mismo par.

Validación de Liquidez

Antes de ejecutar un intercambio utilizando su tasa, el sistema valida que su billetera de tesorería tenga:

Saldo suficiente de tokens del activo de destino para cubrir la salida del intercambio (monto x tasa).
Saldo suficiente de tokens nativos (ETH, BNB, etc.) para cubrir las tarifas de red de la transferencia.

Si el saldo de su billetera es insuficiente, el sistema omite su tasa y pasa al siguiente LP disponible. Recibirá una alerta por correo electrónico cuando su liquidez sea baja.

Mantenga sus billeteras de tesorería bien financiadas para evitar oportunidades de intercambio perdidas. El sistema le notificará cuando los saldos caigan por debajo de los umbrales.

Mejores Prácticas

Gestión de Tasas

Monitoree las condiciones del mercado y actualice las tasas regularmente para mantenerse competitivo
Use bandas de monto para ofrecer precios escalonados para diferentes tamaños de transacción
Desactive las tasas durante mantenimiento o alta volatilidad en lugar de eliminarlas
Revise el historial de versiones para rastrear los cambios de tasas a lo largo del tiempo

Liquidez

Mantenga saldo suficiente en sus billeteras de tesorería tanto para el activo de destino como para tokens nativos
Configure monitoreo para alertas de saldo bajo
Financie las billeteras proactivamente para evitar interrupciones en el servicio

Referencia de API

Endpoint	Descripción
Crear Tasa	Crear una nueva tasa de cambio para un par de activos
Obtener Tasa	Recuperar una tasa individual por ID
Actualizar Tasa	Actualizar una tasa existente (crea una nueva versión)
Desactivar Tasa	Retirar una tasa del servicio
Reactivar Tasa	Volver a poner en servicio una tasa desactivada
Obtener Historial de Tasas	Ver el historial completo de versiones de una tasa

Soporte

Correo electrónico: [email protected]
Convertirse en LP: Aplique aquí para expresar su interés en convertirse en Proveedor de Liquidez

El Pool de Liquidez está diseñado para proveedores de liquidez institucionales y profesionales. Aplique para convertirse en LP, luego pruebe sus configuraciones de tasas en testnet antes de pasar a producción.

Comenzar

Esenciales

Requisitos Previos

Cómo Funciona

Gestión de Tasas

Bandas de Monto

Historial de Versiones

Selección Automática

Ciclo de Vida de las Tasas

1. Crear una Tasa

Parámetros de Solicitud

Respuesta de Creación

2. Actualizar una Tasa

3. Desactivar una Tasa

4. Reactivar una Tasa

Versionado de Tasas

Ejemplo de Cadena de Versiones

Ver Historial de Tasas

Respuesta del Historial

Estados de las Tasas

Bandas de Monto

Múltiples Tasas para el Mismo Par

Validación de Liquidez

Mejores Prácticas

Gestión de Tasas

Liquidez

Referencia de API

Soporte

Comenzar

Esenciales

​Requisitos Previos

​Cómo Funciona

Gestión de Tasas

Bandas de Monto

Historial de Versiones

Selección Automática

​Ciclo de Vida de las Tasas

​1. Crear una Tasa

​Parámetros de Solicitud

​Respuesta de Creación

​2. Actualizar una Tasa

​3. Desactivar una Tasa

​4. Reactivar una Tasa

​Versionado de Tasas

​Ejemplo de Cadena de Versiones

​Ver Historial de Tasas

​Respuesta del Historial

​Estados de las Tasas

​Bandas de Monto

​Múltiples Tasas para el Mismo Par

​Validación de Liquidez

​Mejores Prácticas

​Gestión de Tasas

​Liquidez

​Referencia de API

​Soporte

Requisitos Previos

Cómo Funciona

Ciclo de Vida de las Tasas

1. Crear una Tasa

Parámetros de Solicitud

Respuesta de Creación

2. Actualizar una Tasa

3. Desactivar una Tasa

4. Reactivar una Tasa

Versionado de Tasas

Ejemplo de Cadena de Versiones

Ver Historial de Tasas

Respuesta del Historial

Estados de las Tasas

Bandas de Monto

Múltiples Tasas para el Mismo Par

Validación de Liquidez

Mejores Prácticas

Gestión de Tasas

Liquidez

Referencia de API

Soporte