Pool de Liquidez

Em resumo
O Pool de Liquidez da Blockradar permite que Provedores de Liquidez (LPs) aprovados definam e gerenciem taxas de câmbio para pares de ativos. As taxas alimentam o motor interno de swap — quando um usuário inicia um swap, o sistema seleciona automaticamente a melhor taxa disponível dos LPs ativos, valida a liquidez e executa a transação.

Pré-requisitos

Antes de usar a API do Pool de Liquidez, certifique-se de ter:

Torne-se um Provedor de Liquidez

O Pool de Liquidez está disponível apenas para Provedores de Liquidez aprovados. Para começar, preencha o formulário de candidatura a LP e a equipe da Blockradar analisará sua solicitação e fará sua integração.

Chave API

Após a integração, gere uma chave API no Painel da Blockradar. Navegue até Developers para criar uma.

Financie Suas Carteiras

Certifique-se de que suas carteiras de tesouraria tenham saldo suficiente dos ativos para os quais você planeja fornecer liquidez, além de tokens nativos para cobrir as taxas de rede.

Como Funciona

Como Provedor de Liquidez, você define taxas de câmbio para pares de ativos (ex.: BNB → USDC). Quando um usuário na plataforma Blockradar inicia um swap, o sistema:

Encontra taxas correspondentes de todos os LPs ativos para o par de ativos solicitado.
Classifica os candidatos pela melhor taxa, prioridade do LP e horário de criação.
Valida a liquidez verificando se a carteira de tesouraria do LP selecionado tem saldo suficiente para cumprir o swap.
Executa o swap usando a taxa e a tesouraria do LP selecionado.

Gerenciamento de Taxas

Crie, atualize, desative e reative taxas de câmbio para qualquer par de ativos suportado.

Faixas de Valor

Defina valores mínimos e máximos de transação por taxa para controlar a exposição e segmentar níveis de preço.

Histórico de Versões

Cada alteração de taxa cria uma nova versão. O histórico completo é preservado para auditoria e análise.

Seleção Automática

O sistema seleciona automaticamente o melhor LP para cada swap com base na taxa, prioridade e liquidez disponível.

Ciclo de Vida da Taxa

As taxas seguem um ciclo de vida claro com rastreamento completo de versões:

1. Criar uma Taxa

Defina uma nova taxa de câmbio para um par de ativos. A taxa inicia como active na versão 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 da Requisição

Parâmetro	Tipo	Obrigatório	Descrição
`fromAsset`	string	Sim	O símbolo do ativo de origem (ex.: `BNB`)
`toAsset`	string	Sim	O símbolo do ativo de destino (ex.: `USDC`)
`rate`	string	Sim	A taxa de câmbio. Fornecida como string para evitar problemas de precisão de ponto flutuante
`minAmount`	string	Sim	Valor mínimo de transação para esta taxa (inclusivo)
`maxAmount`	string	Não	Valor máximo de transação (exclusivo). Omita para ilimitado

Resposta de Criação

{
  "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. Atualizar uma Taxa

Modifique a taxa ou as restrições de valor para uma taxa ativa existente. Isso cria uma nova versão — a versão anterior é automaticamente marcada 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"
  }'

Forneça apenas os campos que você deseja alterar — atualizações parciais são suportadas.

3. Desativar uma Taxa

Retire temporariamente uma taxa do ar. A taxa se torna deactivated e não será mais selecionada para swaps.

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. Reativar uma Taxa

Recoloque uma taxa desativada no ar. Isso cria uma nova versão com status active.

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

Versionamento de Taxas

Toda vez que uma taxa é atualizada ou reativada, uma nova versão é criada. A versão anterior é marcada como superseded. Isso fornece uma trilha de auditoria completa.

Campo	Descrição
`version`	Número de versão sequencial começando em 1
`rootRateId`	Aponta para a taxa original — todas as versões em uma cadeia compartilham este ID
`previousRateId`	Aponta para a versão imediatamente anterior

Exemplo de Cadeia de Versões

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

Visualizar Histórico da Taxa

Recupere o histórico completo de versões de uma taxa:

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

Resposta do Histórico

{
  "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
  }
}

Status das Taxas

Status	Descrição
`active`	Atualmente ativa e elegível para seleção de swap
`superseded`	Substituída por uma versão mais recente (via atualização ou reativação)
`deactivated`	Retirada manualmente do ar — pode ser reativada

superseded é um estado terminal — esses registros são históricos e não podem ser modificados.

Faixas de Valor

Cada taxa cobre uma faixa de valor de transação definida por minAmount e maxAmount:

minAmount — O limite inferior inclusivo. Transações abaixo deste valor não usarão esta taxa.
maxAmount — O limite superior exclusivo. Defina como null (omita) para ilimitado.

Múltiplas Taxas para o Mesmo Par

Você pode criar múltiplas taxas para o mesmo par de ativos com diferentes faixas de valor para oferecer preços escalonados:

Taxa	Faixa	Caso de Uso
605.00	0.01 – 10 BNB	Transações pequenas
606.50	10 – 100 BNB	Transações médias
608.00	100+ BNB	Transações grandes

As faixas de valor para o mesmo par de ativos não devem se sobrepor. O sistema rejeitará uma taxa se sua faixa se sobrepuser a outra taxa ativa para o mesmo par.

Validação de Liquidez

Antes de executar um swap usando sua taxa, o sistema valida que sua carteira de tesouraria possui:

Saldo de tokens suficiente do ativo de destino para cobrir a saída do swap (valor x taxa).
Saldo suficiente de tokens nativos (ETH, BNB, etc.) para cobrir as taxas de rede da transferência.

Se o saldo da sua carteira for insuficiente, o sistema ignora sua taxa e passa para o próximo LP disponível. Você receberá um alerta por e-mail quando sua liquidez estiver baixa.

Mantenha suas carteiras de tesouraria bem financiadas para evitar oportunidades de swap perdidas. O sistema notificará você quando os saldos caírem abaixo dos limites.

Melhores Práticas

Gerenciamento de Taxas

Monitore as condições de mercado e atualize as taxas regularmente para se manter competitivo
Use faixas de valor para oferecer preços escalonados para diferentes tamanhos de transação
Desative taxas durante manutenção ou alta volatilidade em vez de excluí-las
Revise o histórico de versões para acompanhar as alterações de taxa ao longo do tempo

Liquidez

Mantenha saldo suficiente em suas carteiras de tesouraria tanto para o ativo de destino quanto para tokens nativos
Configure monitoramento para alertas de saldo baixo
Financie carteiras proativamente para evitar interrupções no serviço

Referência da API

Endpoint	Descrição
Criar Taxa	Criar uma nova taxa de câmbio para um par de ativos
Obter Taxa	Recuperar uma única taxa por ID
Atualizar Taxa	Atualizar uma taxa existente (cria uma nova versão)
Desativar Taxa	Retirar uma taxa do ar
Reativar Taxa	Recolocar uma taxa desativada no ar
Obter Histórico da Taxa	Visualizar o histórico completo de versões de uma taxa

Suporte

E-mail: [email protected]
Torne-se um LP: Candidate-se aqui para expressar seu interesse em se tornar um Provedor de Liquidez

O Pool de Liquidez é projetado para provedores de liquidez institucionais e profissionais. Candidate-se para se tornar um LP e, em seguida, teste suas configurações de taxa na testnet antes de entrar em produção.

Começar

Essenciais

Pré-requisitos

Como Funciona

Gerenciamento de Taxas

Faixas de Valor

Histórico de Versões

Seleção Automática

Ciclo de Vida da Taxa

1. Criar uma Taxa

Parâmetros da Requisição

Resposta de Criação

2. Atualizar uma Taxa

3. Desativar uma Taxa

4. Reativar uma Taxa

Versionamento de Taxas

Exemplo de Cadeia de Versões

Visualizar Histórico da Taxa

Resposta do Histórico

Status das Taxas

Faixas de Valor

Múltiplas Taxas para o Mesmo Par

Validação de Liquidez

Melhores Práticas

Gerenciamento de Taxas

Liquidez

Referência da API

Suporte

Começar

Essenciais

​Pré-requisitos

​Como Funciona

Gerenciamento de Taxas

Faixas de Valor

Histórico de Versões

Seleção Automática

​Ciclo de Vida da Taxa

​1. Criar uma Taxa

​Parâmetros da Requisição

​Resposta de Criação

​2. Atualizar uma Taxa

​3. Desativar uma Taxa

​4. Reativar uma Taxa

​Versionamento de Taxas

​Exemplo de Cadeia de Versões

​Visualizar Histórico da Taxa

​Resposta do Histórico

​Status das Taxas

​Faixas de Valor

​Múltiplas Taxas para o Mesmo Par

​Validação de Liquidez

​Melhores Práticas

​Gerenciamento de Taxas

​Liquidez

​Referência da API

​Suporte

Pré-requisitos

Como Funciona

Ciclo de Vida da Taxa

1. Criar uma Taxa

Parâmetros da Requisição

Resposta de Criação

2. Atualizar uma Taxa

3. Desativar uma Taxa

4. Reativar uma Taxa

Versionamento de Taxas

Exemplo de Cadeia de Versões

Visualizar Histórico da Taxa

Resposta do Histórico

Status das Taxas

Faixas de Valor

Múltiplas Taxas para o Mesmo Par

Validação de Liquidez

Melhores Práticas

Gerenciamento de Taxas

Liquidez

Referência da API

Suporte