> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levery.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Explorar Pools
> Como usuários finais navegam por pools, interpretam APR/TVL/Volume 24h e abrem Stats, Swap ou Invest.
A página Pools é o **diretório de mercados** da instância do venue. Ela lista pools suportadas e fornece um conjunto compacto de
indicadores usados para escolher um mercado e navegar para as telas de execução e análise da plataforma.
***
## O que explorar pools permite
Explorar pools ajuda usuários finais de uma instituição a:
* descobrir mercados suportados sem precisar conhecer endereços de contratos ou identificadores de pools,
* comparar pools entre redes usando métricas consistentes e padronizadas pelo venue,
* abrir **Stats** para revisar condições de mercado antes de executar trades ou prover liquidez,
* navegar para os fluxos de **Swap** e **Invest** preservando o contexto de chain.
Pools são exibidas como par e rede, com APR, TVL e volume 24h como sinais rápidos. Valores ausentes aparecem como traços para evitar falsa precisão.
Cada linha roteia para telas específicas do pool: selecionar a linha abre Stats, enquanto os botões de ação abrem Swap e Invest para o mesmo pool na mesma chain.
***
## Layout e interações da página
### Tabela de pools
A tabela de Pools normalmente inclui:
* **Pool:** Rótulo do par (`asset0 / asset1`) e ícones dos tokens.
* **Rede:** Nome da chain e ícone da chain.
* **APR:** Estimativa anualizada quando disponível; caso contrário `–`.
* **TVL:** Total value locked na moeda de exibição do venue; caso contrário `–`.
* **Volume 24h:** Volume de swaps em 24 horas na moeda de exibição do venue; caso contrário `–`.
* **Ações:** Links para **Swap** e **Invest** para o pool selecionado.
### Seleção de linha
Selecionar uma linha de pool abre a tela de **Stats** do pool. Esse caminho de navegação é a forma padrão de inspecionar um pool
antes de escolher uma ação.
### Estados visíveis
* **Carregando:** A tabela renderiza “Loading pools…” enquanto a lista é carregada.
* **Erro:** Uma mensagem de erro em vermelho aparece quando a lista não pode ser carregada.
* **Vazio:** Nenhuma linha é exibida quando não há pools visíveis na instância do venue.
***
## Interpretando métricas de pool
A página Pools exibe um pequeno conjunto de **indicadores operacionais**. Esses valores são usados para triagem e navegação,
não como garantias.
### APR
APR é uma estimativa anualizada derivada da atividade recente de taxas em relação à base de liquidez atual.
* APR **não é promessa** de performance futura.
* APR pode estar indisponível para pools novas ou em períodos em que métricas não são computadas; a UI renderiza `–`.
### TVL
TVL expressa o valor atual de liquidez do pool na moeda de exibição do venue.
* TVL mais alto geralmente se correlaciona com precificação mais justa e maior capacidade para trades maiores.
* TVL é exibido como valor monetário e pode ser arredondado para legibilidade.
### Volume 24h
Volume 24h expressa a atividade recente de swaps na moeda de exibição do venue.
* Volume mais alto pode indicar um mercado mais ativo e geração mais frequente de taxas para posições de LP.
* Volume pode estar indisponível ou atrasado; a UI renderiza `–`.
***
## Pré-requisitos de execução e comportamento de taxas
A página Pools é uma superfície de descoberta. Checagens de elegibilidade e execução ocorrem nas telas de ação seguintes.
### Carteira e rede
* Fluxos de **Swap** e **Invest** exigem uma carteira conectada.
* A execução exige que a carteira esteja na **rede** do pool. Um pool pode ser listado mesmo quando a carteira está em outra chain; a execução ocorre apenas na chain do pool.
### Permissões e políticas
Dependendo da política do venue, ações podem ser bloqueadas por:
* checagens de permissão de swap,
* checagens de permissão de liquidez,
* papéis exigidos pelo pool,
* controles de pausa de emergência,
* restrições baseadas em oráculo para controle de taxas de swap.
Essas checagens normalmente aparecem como ações desabilitadas, simulações falhas ou transações revertidas nas telas de ação.
***
## Fluxos do usuário final a partir desta página
O usuário final revisa o par e a rede, e usa TVL e volume como sinais de liquidez e atividade.
Selecionar a linha abre Stats do pool, que normalmente é usado para validar condições de mercado antes de executar operações de swap ou invest.
Selecionar **Swap** direciona para a tela de Swap com escopo no pool selecionado.
**Checagens comuns**
* A conexão de carteira está presente e a carteira está na chain do pool.
* Aprovações exigidas pelo caminho de swap são satisfeitas antes do envio.
* Políticas de acesso (permissões/papéis/pausa/restrições de oráculo) permitem a execução.
**Comportamento de taxas**
* Taxas de serviço são cobradas apenas nos fluxos de execução de swap.
Selecionar **Invest** direciona para a tela de provisionamento de liquidez com escopo no pool selecionado.
**Checagens comuns**
* A conexão de carteira está presente e a carteira está na chain do pool.
* Aprovações exigidas pelo caminho de liquidez são satisfeitas antes do envio.
* Políticas de acesso (permissões/papéis/controles de pausa) permitem a execução.
**Comportamento de taxas**
* Taxas de serviço não são cobradas em eventos de liquidez.
***
## Orientação de suporte
Swap e Invest executam apenas na chain do pool. Se a carteira estiver em uma rede diferente, o fluxo de ação não pode concluir até que a chain corresponda ao pool.
Em algumas situações, um pool pode estar visível enquanto a execução é bloqueada por permissões de swap/liquidez ou um papel exigido pelo pool. O acesso é concedido pelo fluxo de aprovação da instituição.
Fluxos ERC-20 podem exigir uma ou mais aprovações antes da execução. Aprovações ausentes geralmente aparecem como simulação falha ou transação revertida.
A execução de swap pode reverter quando o preço se move além da tolerância configurada ou quando o deadline expira. Volatilidade de mercado aumenta a probabilidade de falha.
Cotações podem falhar sob degradação de RPC ou desync temporário do nó. Tentar novamente, trocar RPC ou selecionar outro pool pode restaurar cotação e execução.
Métricas exibidas como `–` indicam valores não computados para o snapshot atual. Isso é comum em pools novas ou durante períodos de atualização do indexador.
***
# Pool Stats
Pool Stats é a **visão analítica de um único pool** na instância do venue. Ela consolida atividade recente, sinais de taxas e um snapshot atual de liquidez, e fornece atalhos para Swap e Invest no mesmo pool e rede.
### Pontos de entrada
* Selecionar uma linha de pool em **Explorar Pools** abre Pool Stats com escopo nesse pool.
* Navegação direta pode abrir Pool Stats para uma chain específica e identificador de pool.
Pool Stats permanece legível sem carteira conectada; a execução de Swap e Invest exige conexão de carteira nos fluxos seguintes.
***
## Anatomia da tela
O cabeçalho mostra o nome do pool e a chain, além de um valor destacado de **Volume Total** para o período selecionado. As abas de período controlam a agregação: 1D, 7D, 1M, 1Y, ALL.
Gráficos de volume e taxas resumem a atividade de swaps, enquanto o painel de Stats destaca APR estimado, saldos virtuais do pool, TVL, volume 24h e taxas de LP 24h. Uma tabela de transações lista swaps recentes.
***
## Cabeçalho e seleção de período
### Identidade do pool e chain
O cabeçalho exibe:
* **Nome do pool:** rótulo do par para o mercado selecionado.
* **Chain:** nome da rede e ícone da chain do pool.
### Volume Total (período selecionado)
Um número destacado de **Volume Total** resume o volume de swaps para a aba de período selecionada.
* O Volume Total muda ao alternar entre 1D, 7D, 1M, 1Y e ALL.
* Valores são exibidos na moeda de exibição do venue.
### Abas de período
Uma faixa de cinco opções controla a janela do gráfico:
* **1D** (baldes horários)
* **7D** (baldes de múltiplas horas)
* **1M** (baldes diários; padrão)
* **1Y** (baldes semanais)
* **ALL** (baldes mensais)
A granularidade dos baldes é derivada da janela do gráfico e pode diferir de provedores externos de analytics.
***
## Gráficos de atividade
Pool Stats renderiza dois gráficos para a janela de tempo selecionada:
* **Volume:** volume de swaps na moeda de exibição do venue.
* **Taxas:** taxas de execução de swaps na moeda de exibição do venue.
As taxas nesta tela são computadas a partir da **taxa de LP** do pool mais a **taxa de serviço** do venue para os swaps incluídos em cada balde.
Taxas de serviço são cobradas **apenas** nos fluxos de execução de swap. Taxas de serviço **não** são cobradas em eventos de liquidez.
***
## Snapshot de Stats
### APR estimado
O painel de Stats mostra um **APR estimado**:
* Quando um snapshot de APR está disponível para o pool, esse valor é exibido.
* Caso contrário, a estimativa recua para: **(Taxas de LP 24h ÷ TVL) × 365**.
APR é um indicador operacional e não é garantia de retornos futuros.
### Saldos do Pool
“Saldos do Pool” exibe montantes indicativos dos dois ativos do pool e uma barra de divisão proporcional.
* A barra de divisão visualiza a participação relativa entre os dois lados.
* Valorações indicativas em fiat para cada lado são mostradas abaixo dos montantes.
### TVL, Volume 24h, Taxas de LP 24h
Campos adicionais fornecem um snapshot compacto do pool:
* **TVL:** Total value locked na moeda de exibição do venue.
* **Volume 24h:** volume de swaps acumulado em 24 horas.
* **Taxas de LP 24h:** taxas de LP de swaps acumuladas em 24 horas.
### Atalhos de Swap e Invest
O rodapé do painel de Stats inclui:
* **Swap:** direciona para Swap para o mesmo pool e chain.
* **Invest:** direciona para Invest para o mesmo pool e chain.
A elegibilidade de execução é aplicada nos fluxos seguintes (conexão de carteira, alinhamento de rede, aprovações e políticas do venue).
***
## Transações
O painel de Transações lista swaps recentes para o pool selecionado e normalmente mostra até as entradas mais recentes disponíveis para exibição.
### Campos
* **TX Hash:** hash de transação abreviado usado para verificação externa.
* **Tipo:** rótulo direcional derivado do swap (por exemplo, “Buy SYMBOL”).
* **Token0 / Token1:** magnitudes absolutas para os valores dos dois ativos do pool.
* **Fiat:** valor indicativo pago no lado de entrada, expresso na moeda de exibição do venue.
* **Fee:** taxas indicativas de execução de swap para a negociação (taxa de LP mais taxa de serviço).
* **Conta:** endereço iniciador do swap.
* **Hora:** timestamp usado para ordenação (renderizado como `YYYY-MM-DD HH:MM`).
***
## Efeitos de política
Pool Stats é informativo e não concede direitos de execução por si só. Resultados observados após navegar para Swap ou Invest comumente refletem a política do venue, incluindo:
* checagens de permissão de swap,
* checagens de permissão de liquidez,
* papéis exigidos pelo pool,
* controles de pausa de emergência,
* restrições baseadas em oráculo que afetam condições de execução de swaps.
***
## Sinais operacionais de suporte
O Volume Total reflete a aba de período selecionada, enquanto o Volume 24h é sempre uma janela móvel de 24 horas. Diferenças são esperadas quando o período selecionado não é 1D.
Taxas exibidas refletem cobranças de execução de swap: taxas de LP mais taxa de serviço do venue. Taxas de serviço aplicam-se apenas a swaps e
não são cobradas em eventos de liquidez.
O estado vazio indica que não há swaps disponíveis para exibição no pool selecionado. Pools novas ou com baixa atividade
comumente atingem esse estado.
Falhas após o roteamento normalmente refletem checagens subsequentes: chain errada, aprovações ausentes, limites de slippage/deadline,
ou políticas (permissões/papéis/pausa).
Janelas de baixa atividade podem produzir gráficos esparsos. Expandir o período para 1M, 1Y ou ALL pode fornecer contexto mais claro
quando disponível.
Valores em fiat são indicativos e podem mudar com variações de preço. Use o TX hash em um explorador externo para reconciliação autoritativa.
***
## Notas de segurança e operações
* **Verificação:** métricas de pool são indicativas; a reconciliação definitiva usa recibos on-chain e exploradores externos. O TX hash é a âncora principal para validar valores, taxas e ordenação.
* **Postura não custodial:** a execução ocorre via contratos inteligentes; fundos permanecem sob controle da carteira, exceto por fluxos explícitos baseados em aprovação.
* **Resistência a phishing:** assinaturas e aprovações devem ser revisadas na carteira, com atenção especial à identidade do spender e à seleção de chain.
* **Invariantes de taxas:** taxas de serviço se aplicam apenas a fluxos de execução de swap; eventos de liquidez não incluem deduções de taxa de serviço.