Calculadora de perda impermanente

Esta calculadora de perda impermanente aceita initial_price e final_price de um ativo do pool cotado no outro, opcionalmente um deposit, e devolve o ratio de preços, a fração e o percentual com sinal da perda impermanente, os fatores de valor do LP e de retenção e —quando um deposit é informado— o valor do LP, o de retenção e o valor da perda em unidades de cotação.

O que é a perda impermanente e como funciona a fórmula 50/50

Quando o preço externo do ativo A cotado no ativo B passa de initial_price para final_price, a arbitragem rebalanceia as reservas para que o produto permaneça constante e o ratio de valor acompanhe o novo preço. Depois desse movimento a posição LP vale o deposit original vezes a raiz quadrada de k, em que k é final_price dividido por initial_price. Taxas de swap, liquidez concentrada, pesos desequilibrados e pools com vários ativos ficam fora do escopo: este endpoint responde à pergunta de IL 50/50 de produto constante em forma fechada a partir de uma única variação de ratio de preços entre os dois ativos do pool.

Contrato de entrada, arredondamento e comportamento de erro

Ambos devem ser maiores que zero. Opcionalmente envie decimals como um inteiro de zero a oito que controla o arredondamento half-up de cada campo numérico (padrão seis). O arredondamento half-up é aplicado uma vez a cada campo de saída a partir do cálculo em ponto flutuante, para que os goldens fiquem estáveis entre runtimes. Envie por POST um objeto JSON com dois números finitos obrigatórios: initial_price, a cotação de um ativo do pool no outro no depósito, e final_price, a mesma cotação no momento posterior. Opcionalmente envie deposit como um montante finito positivo em qualquer unidade de cotação para a resposta escalar os fatores em lp_value, hold_value e impermanent_loss_value; omita deposit e essas três chaves são omitidas em vez de voltarem como null. Cadeias numéricas que se interpretam como valores finitos são aceitas como os números JSON. Os aliases start_price e p0 mapeiam para initial_price; end_price e p1 para final_price; amount e principal para deposit. Campos ausentes, valores não finitos, preços ou deposit não positivos e decimals fora da faixa falham com invalid_input e não são cobrados. No sucesso o corpo ecoa os preços arredondados, price_ratio k, price_change_percent, lp_value_factor (raiz quadrada de k), hold_value_factor ((1+k)/2), impermanent_loss_fraction e impermanent_loss_percent com sinal, e uma string formula curta que você pode mostrar ao lado dos números. Combine esta API com o seu próprio módulo de taxas ou de faixa se precisar do desempenho líquido do LP; a calculadora não soma taxas de swap nem ticks do Uniswap v3.

Onde uma calculadora de perda impermanente justifica o seu lugar

Scripts de portfólio e de analítica marcam um livro LP a um ratio novo e precisam de um endpoint parse determinístico em vez de um passo de colar na planilha. Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída, e a validação falha não consome saldo. Varra final_price em um laço no seu código para tabelas de cenários; fixe impermanent_loss_percent e, quando enviar deposit, impermanent_loss_value nos testes; mantenha as requisições pequenas. O caminho gratuito do navegador usa o mesmo módulo puro da API, de modo que demos e produção nunca divergem.