Liquidity Pool

En resumen
El Liquidity Pool de Blockradar permite que los Liquidity Providers (LPs) aprobados definan y gestionen tipos de cambio para pares de activos. Las tasas alimentan el motor interno de swaps: cuando un usuario inicia un swap, el sistema selecciona automáticamente la mejor tasa disponible de los LPs activos, valida la liquidez y ejecuta la transacción.

Requisitos previos

Antes de utilizar la API del Liquidity Pool, asegúrese de contar con:

Conviértase en Liquidity Provider

El Liquidity Pool está disponible únicamente para Liquidity Providers 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 Dashboard de Blockradar. Vaya a Developers para crear una.

Financie sus wallets

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

Cómo funciona

Como Liquidity Provider, usted define tipos de cambio para pares de activos (por ejemplo, BNB → USDC). Cuando un usuario en la plataforma de Blockradar inicia un swap, el sistema:

Encuentra tasas coincidentes de todos los LPs activos para el par de activos solicitado.
Clasifica los candidatos por mejor tasa, prioridad del LP y hora de creación.
Valida la liquidez comprobando que la wallet de tesorería del LP seleccionado tenga saldo suficiente para cumplir con el swap.
Ejecuta el swap utilizando la tasa y la tesorería del LP seleccionado.

Rate Management

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

Amount Bands

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

Version History

Cada cambio de tasa crea una nueva versión. Se conserva el historial completo para auditoría y análisis.

Automatic Selection

El sistema selecciona automáticamente el mejor LP para cada swap en función de la tasa, la prioridad y la liquidez disponible.

Ciclo de vida de la tasa

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

1. Crear una tasa

Defina un nuevo tipo 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 la solicitud

Parámetro	Tipo	Requerido	Descripción
`fromAsset`	string	Sí	El símbolo del activo a convertir desde (por ejemplo, `BNB`)
`toAsset`	string	Sí	El símbolo del activo a convertir a (por ejemplo, `USDC`)
`rate`	string	Sí	El tipo de cambio. Se proporciona como cadena para evitar problemas de precisión de coma flotante
`minAmount`	string	Sí	Monto mínimo de transacción para esta tasa (inclusive)
`maxAmount`	string	No	Monto máximo de transacción (exclusivo). Omita para que sea 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 de 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"
  }'

Proporcione únicamente los campos que desea cambiar: se admiten actualizaciones parciales.

3. Desactivar una tasa

Retire temporalmente una tasa. La tasa pasa a estar deactivated y ya no se seleccionará para swaps.

curl --request PATCH \
  --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 línea una tasa desactivada. Esto crea una nueva versión con estado active.

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

Pricing Tools

Antes de cotizar un nuevo nivel o reajustar uno existente, utilice las Pricing Tools para inspeccionar su propia cobertura y compararse con otros Liquidity Providers del mismo segmento de negocio.

Consultar tasas activas para un par

GET /rates/check-pair devuelve todas las tasas activas que ha configurado para un par de activos en el entorno actual, incluida la banda de monto de cada una. Úselo para confirmar si ya está cotizando un par antes de abrir un nuevo nivel.

curl --request GET \
  --url 'https://api.blockradar.co/v1/rates/check-pair?fromAsset=USDT&toAsset=cNGN' \
  --header 'x-api-key: <api-key>'

Response

{
  "message": "Pair check completed",
  "statusCode": 200,
  "data": {
    "fromAsset": "USDT",
    "toAsset": "cNGN",
    "hasActiveRates": true,
    "activeRateCount": 2,
    "rates": [
      {
        "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
        "rate": "1545.00",
        "minAmount": "10",
        "maxAmount": "1000",
        "version": 1,
        "createdAt": "2026-04-12T09:14:22.501Z"
      },
      {
        "id": "5b6683f0-6e92-4eaf-ae8d-5f2ddd76b376",
        "rate": "1547.50",
        "minAmount": "1000",
        "maxAmount": null,
        "version": 3,
        "createdAt": "2026-04-12T09:18:41.022Z"
      }
    ]
  }
}

Comparar con otros LPs

GET /rates/market-benchmark devuelve la mejor tasa competidora para un par de activos entre otros Liquidity Providers de su segmento de negocio. Sus propias tasas se excluyen para que pueda ver con qué está compitiendo. Los resultados se almacenan en caché durante 60 segundos por par. Pase amount para restringir el benchmark a las tasas cuya banda cubra ese tamaño de transacción, o pase pairs (entradas from:to separadas por comas, máximo 20) para obtener un arreglo de benchmarks en una sola llamada.

curl --request GET \
  --url 'https://api.blockradar.co/v1/rates/market-benchmark?fromAsset=USDT&toAsset=cNGN' \
  --header 'x-api-key: <api-key>'

Single pair response

{
  "message": "Market benchmark retrieved",
  "statusCode": 200,
  "data": {
    "fromAsset": "USDT",
    "toAsset": "cNGN",
    "bestRate": "1547.50"
  }
}

Batch response

{
  "message": "Market benchmark retrieved",
  "statusCode": 200,
  "data": [
    { "fromAsset": "USDT", "toAsset": "cNGN", "bestRate": "1547.50" },
    { "fromAsset": "cNGN", "toAsset": "USDT", "bestRate": "0.000647" }
  ]
}

bestRate es null cuando ningún otro LP tiene una tasa activa para el par (o para la banda de monto proporcionada).

Inspeccionar saldos de tesorería

GET /rates/treasury-balances devuelve los saldos de tesorería agregados de cada activo que aparece en sus tasas activas, desglosados por blockchain. Úselo para supervisar la cobertura de liquidez en los pares que está cotizando. La respuesta excluye activos con saldo on-chain igual a cero y elimina entradas duplicadas cuando varias tasas hacen referencia al mismo par activo/wallet.

curl --request GET \
  --url https://api.blockradar.co/v1/rates/treasury-balances \
  --header 'x-api-key: <api-key>'

Response

{
  "message": "Treasury balances retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "asset": "USDT",
      "totalBalance": "5000.00",
      "totalConvertedBalance": "5000.00",
      "chains": [
        {
          "blockchain": "ethereum",
          "balance": "3000.00",
          "convertedBalance": "3000.00",
          "walletAddress": "0xA1b2C3d4E5f6789012345678901234567890aBcD"
        },
        {
          "blockchain": "polygon",
          "balance": "2000.00",
          "convertedBalance": "2000.00",
          "walletAddress": "0xA1b2C3d4E5f6789012345678901234567890aBcD"
        }
      ]
    }
  ]
}

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 de 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 el historial de la tasa

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": [
    {
      "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
      "fromAsset": "BNB",
      "toAsset": "USDC",
      "network": "testnet",
      "rate": "605.50",
      "minAmount": "0.01",
      "maxAmount": null,
      "isActive": false,
      "status": "deactivated",
      "version": 1,
      "previousRateId": null,
      "rootRateId": null,
      "createdBy": "86964e42-79dc-4267-a2ca-3612c4b095a8",
      "deactivatedBy": "86964e42-79dc-4267-a2ca-3612c4b095a8",
      "deactivatedAt": "2026-02-25T18:13:48.113Z",
      "deactivationReason": "re",
      "createdAt": "2026-02-19T07:50:17.042Z",
      "updatedAt": "2026-02-25T18:13:48.101Z"
    }
  ],
  "meta": {
    "totalItems": 1,
    "itemCount": 1,
    "itemsPerPage": 10,
    "totalPages": 1,
    "currentPage": 1
  }
}

Estados de la tasa

Estado	Descripción
`active`	Actualmente vigente y elegible para selección en swaps
`superseded`	Reemplazada por una versión más reciente (mediante actualización o reactivación)
`deactivated`	Retirada manualmente: puede reactivarse

superseded es un estado terminal: estos registros son históricos y no pueden modificarse.

Amount Bands

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

minAmount: el límite inferior inclusivo. Las transacciones por debajo de este monto no usarán esta tasa.
maxAmount: el límite superior exclusivo. Establézcalo en null (omita) para que sea ilimitado.

Múltiples tasas para el mismo par

Puede crear varias 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 swap utilizando su tasa, el sistema valida que su wallet de tesorería tenga:

Saldo de token suficiente del activo de destino para cubrir la salida del swap (amount x rate).
Saldo suficiente de token nativo (ETH, BNB, etc.) para cubrir las comisiones de red de la transferencia.

Si el saldo de su wallet 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 wallets de tesorería bien financiadas para evitar perder oportunidades de swap. El sistema le notificará cuando los saldos caigan por debajo de los umbrales.

Buenas prácticas

Rate Management

Supervise las condiciones del mercado y actualice las tasas con regularidad para mantenerse competitivo
Use Amount Bands para ofrecer precios escalonados según los distintos tamaños de transacción
Desactive las tasas durante mantenimiento o alta volatilidad en lugar de eliminarlas
Revise el Version History para hacer seguimiento de los cambios de tasa a lo largo del tiempo

Liquidez

Mantenga saldo suficiente en sus wallets de tesorería tanto del activo de destino como de los tokens nativos
Configure el monitoreo para recibir alertas de saldo bajo
Financie las wallets de forma proactiva para evitar interrupciones del servicio

Referencia de la API

Endpoint	Descripción
Create Rate	Cree un nuevo tipo de cambio para un par de activos
Get Rate	Recupere una sola tasa por ID
Update Rate	Actualice una tasa existente (crea una nueva versión)
Deactivate Rate	Retire una tasa
Reactivate Rate	Vuelva a poner en línea una tasa desactivada
Get Rate History	Vea el historial completo de versiones de una tasa
Check Pair	Liste sus tasas activas para un par de activos específico
Get Market Benchmark	Mejor tasa competidora para un par (o un lote de pares), excluyendo las suyas
Get Treasury Balances	Saldos de tesorería agregados agrupados por activo y blockchain

Soporte

Correo electrónico: [email protected]
Conviértase en LP: Postule aquí para manifestar su interés en convertirse en Liquidity Provider

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

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Requisitos previos

Cómo funciona

Rate Management

Amount Bands

Version History

Automatic Selection

Ciclo de vida de la tasa

1. Crear una tasa

Parámetros de la solicitud

Respuesta de creación

2. Actualizar una tasa

3. Desactivar una tasa

4. Reactivar una tasa

Pricing Tools

Consultar tasas activas para un par

Comparar con otros LPs

Inspeccionar saldos de tesorería

Versionado de tasas

Ejemplo de cadena de versiones

Ver el historial de la tasa

Respuesta del historial

Estados de la tasa

Amount Bands

Múltiples tasas para el mismo par

Validación de liquidez

Buenas prácticas

Rate Management

Liquidez

Referencia de la API

Soporte

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Documentation Index

​Requisitos previos

​Cómo funciona

Rate Management

Amount Bands

Version History

Automatic Selection

​Ciclo de vida de la tasa

​1. Crear una tasa

​Parámetros de la solicitud

​Respuesta de creación

​2. Actualizar una tasa

​3. Desactivar una tasa

​4. Reactivar una tasa

​Pricing Tools

​Consultar tasas activas para un par

​Comparar con otros LPs

​Inspeccionar saldos de tesorería

​Versionado de tasas

​Ejemplo de cadena de versiones

​Ver el historial de la tasa

​Respuesta del historial

​Estados de la tasa

​Amount Bands

​Múltiples tasas para el mismo par

​Validación de liquidez

​Buenas prácticas

​Rate Management

​Liquidez

​Referencia de la API

​Soporte

Requisitos previos

Cómo funciona

Ciclo de vida de la tasa

1. Crear una tasa

Parámetros de la solicitud

Respuesta de creación

2. Actualizar una tasa

3. Desactivar una tasa

4. Reactivar una tasa

Pricing Tools

Consultar tasas activas para un par

Comparar con otros LPs

Inspeccionar saldos de tesorería

Versionado de tasas

Ejemplo de cadena de versiones

Ver el historial de la tasa

Respuesta del historial

Estados de la tasa

Amount Bands

Múltiples tasas para el mismo par

Validación de liquidez

Buenas prácticas

Rate Management

Liquidez

Referencia de la API

Soporte