Métricas

Todo resultado bem-sucedido de /v1/quotes contém um objeto metrics. Todas as taxas são decimais; os preços são por 100 de valor de face.

Preço e provisionamento

Campo	Significado
dirty_price	preço sujo (valor presente dos fluxos de caixa remanescentes)
clean_price	preço sujo menos os juros acumulados
accrued_interest	juros acumulados desde o último cupom (coupon corrido)
accrued_days	dias de provisionamento na liquidação

Rendimento

Campo	Significado
yield	o rendimento, na base do rate_type do instrumento
current_yield	cupom anual ÷ preço
tec	TEC — a taxa efetiva anual exata de compra (não uma heurística)
yield_to_worst	apenas para títulos resgatáveis (callables) — min(YTM, todos os rendimentos até o resgate); presente quando options.yield_worst e aplicável

Risco

Campo	Significado
macaulay_duration	tempo médio ponderado até os fluxos de caixa (anos)
modified_duration	sensibilidade do preço ao rendimento (−dP/dy ÷ P)
convexity	sensibilidade de segunda ordem preço/rendimento
dv01	variação monetária no preço por movimento de 1 bp no rendimento
sherman_ratio	rendimento por unidade de duração
duration_applicable	false para PRICE_QUANTITY (métricas de risco não são significativas)

Valores monetários (quando você fornece um amount)

Se a cotação inclui amount_kind / amount_value, o resultado adiciona um bloco amounts que escala os preços por 100 pelo tamanho da operação:

Campo	Significado
nominal	o valor de face resolvido
clean_amount	preço limpo × nominal / 100
accrued_amount	acumulado × nominal / 100
dirty_amount	preço sujo × nominal / 100 (o caixa de liquidação)
quantity	nominal ÷ unit_nominal

Próximo cupom e fluxos de caixa

Todo resultado inclui um resumo de next_coupon (date, interest, amortization, total, present_value). Defina options.with_cashflows: true para também receber o cronograma descontado completo (cada fluxo com sua data, valor, fator de desconto e valor presente).

:::info How yields are solved Quando você cota por preço, o emrgex inverte preço → rendimento com um solver híbrido Newton-Raphson + Brent delimitado para garantir a convergência. Um cálculo não convergente retorna um erro 422 tipado, nunca um número errado de forma silenciosa. :::