emrgex — calculadora de renda fixa

O emrgex é uma API para precificação de instrumentos de renda fixa (renta fija). Envie um título e uma cotação e ele retorna o preço, o rendimento, os juros acumulados e um conjunto completo de métricas de risco — ou envie um preço e ele resolve o rendimento. Ele lida com títulos públicos e corporativos, papéis do mercado monetário, estruturas amortizáveis e resgatáveis (callable), e instrumentos indexados.

O que ele faz

• Preço ↔ rendimento. Cote por yield, clean_price, dirty_price ou um valor financeiro transacted; o emrgex calcula o restante.
• Métricas de risco. Preço limpo/sujo, juros acumulados, duração de Macaulay e duração modificada, convexidade, DV01, rendimento corrente, TEC (taxa efetiva anual de compra), índice de Sherman e yield-to-worst para títulos resgatáveis (callable).
• Fluxos de caixa & carrego. Gere o cronograma de fluxos de caixa de um título ou calcule o carrego diário até um horizonte.
• Lote. Precifique milhares de instrumentos em uma única requisição.

A ideia central: convenções globais nomeadas

Em vez de códigos opacos e específicos de cada produto, um cálculo no emrgex é definido por três eixos independentes e globalmente reconhecidos:

Eixo	O que define	Exemplos
rate_type	como o rendimento capitaliza	NOMINAL, EFFECTIVE, AT_MATURITY
day_count	como o tempo é medido (FpML / ISDA)	ACT/ACT.ICMA, 30E/360, BUS/252
coupon_type	como o valor do cupom é calculado	FIXED, ACCRUAL

Qualquer rate_type combina com qualquer day_count; sua junção é o calculation_code do instrumento (por exemplo, ACT/ACT.ICMA|NOMINAL). Veja Convenções.

Duas formas de precificar

• Instrumentos armazenados — referencie um título já existente no catálogo por seu id.
• Instrumentos ad-hoc — defina o título diretamente na sua requisição.

Ambos recalculam a avaliação completa a cada chamada. Veja Instrumentos.

Próximos passos

• Primeiros passos — faça sua primeira requisição.
• Referência da API — o endpoint /v1/quotes por completo.
• Exemplos — receitas prontas para copiar e colar.

:::note Base URL O serviço de desenvolvimento está em https://calc.dev.emrgex.com. Todos os endpoints estão sob /v1. :::