Pular para o conteúdo principal

Exemplos

Receitas para copiar e colar contra https://calc.dev.emrgex.com. Todas as taxas são decimais (0.10 = 10%), os preços são por 100 de valor de face e as datas estão em ISO.

Precificar um título armazenado pelo rendimento​

curl -s https://calc.dev.emrgex.com/v1/quotes -H 'content-type: application/json' -d '{
  "quotes": [
    { "instrument_id": "MH12034", "input_kind": "yield", "input_value": 0.10,
      "settlement_date": "2026-06-09", "options": { "round": 6 } }
  ]
}'

Resolver um rendimento a partir de um preço limpo​

curl -s https://calc.dev.emrgex.com/v1/quotes -H 'content-type: application/json' -d '{
  "quotes": [
    { "instrument_id": "MH12034", "input_kind": "clean_price", "input_value": 107.85,
      "settlement_date": "2026-06-09", "options": { "round": 6 } }
  ]
}'

Precificar um título ad-hoc​

curl -s https://calc.dev.emrgex.com/v1/quotes -H 'content-type: application/json' -d '{
  "instruments": [
    { "id": "B1", "rate_type": "NOMINAL", "day_count": "ACT/ACT.ICMA", "coupon_type": "FIXED",
      "frequency": 2, "start": "2020-01-15", "maturity": "2030-01-15",
      "coupon_rate": 0.06, "face_value": 100 }
  ],
  "quotes": [
    { "instrument_id": "B1", "input_kind": "clean_price", "input_value": 95.5,
      "settlement_date": "2024-06-18", "options": { "round": 6 } }
  ]
}'

Caixa de liquidação para um tamanho de negociação​

curl -s https://calc.dev.emrgex.com/v1/quotes -H 'content-type: application/json' -d '{
  "quotes": [
    { "instrument_id": "MH12034", "input_kind": "yield", "input_value": 0.10,
      "amount_kind": "nominal", "amount_value": 1000000,
      "settlement_date": "2026-06-09", "options": { "round": 6 } }
  ]
}'

O resultado adiciona um bloco amounts (clean_amount, accrued_amount, dirty_amount = caixa de liquidação, quantity).

Lote — precifique vários de uma vez​

curl -s https://calc.dev.emrgex.com/v1/quotes -H 'content-type: application/json' -d '{
  "quotes": [
    { "instrument_id": "MH12034", "input_kind": "yield", "input_value": 0.10, "settlement_date": "2026-06-09" },
    { "instrument_id": "MH12034", "input_kind": "yield", "input_value": 0.11, "settlement_date": "2026-06-09" },
    { "instrument_id": "MH12034", "input_kind": "clean_price", "input_value": 105.0, "settlement_date": "2026-06-09" }
  ]
}'

Cada cotação retorna seu próprio status; uma falha nunca compromete as demais.

Título resgatável (callable) — rendimento ao pior cenário (yield-to-worst)​

Cote um título resgatável pelo preço e solicite o pior rendimento:

... "input_kind": "clean_price", "input_value": 101.5, "options": { "yield_worst": true } ...

O metrics.yield_to_worst do resultado é o min(rendimento até o vencimento, cada rendimento até o resgate).

Título indexado (NTN-B do Brasil, UDIBONO do México)​

Forneça o nominal indexado publicado (VNA) na avaliação via index_ratio; toda saída monetária é multiplicada por index_ratio/100:

... "options": { "index_ratio": 4250.123456, "round": 6 } ...

As métricas de forma (yield, duração, convexidade) são independentes de unidade e não são afetadas.

Convenções regionais​

MercadoConvenção típica
Brasil (LTN / NTN-F)day_count: BUS/252 (dias úteis, calendário ANBIMA)
México (Bonos M / CETES)NOMINAL / AT_MATURITY com a base ACT relevante
Rep. Dominicana (títulos do MoH)day_count: ACT/ACT.DRMH + discount_day_count: ACT/ACT.ICMA

Essas já vêm pré-configuradas no catálogo armazenado; para títulos ad-hoc, defina-as no instrumento. Veja Convenções.

:::tip Going fast Para grandes lotes, omita with_cashflows (respostas muito menores e muito mais rápidas) e envie um único lote grande em vez de muitas requisições individuais. :::