Altri endpoint

Tutti gli endpoint si trovano sotto https://calc.dev.emrgex.com/v1.

POST /v1/carry

Carry giornaliero (interesse effettivo) per un insieme di strumenti ad-hoc e/o memorizzati — in batch. Ogni elemento carries fa riferimento a uno strumento e fornisce un input e (opzionalmente) un orizzonte carry_to (vuoto = data della cedola successiva).

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

POST /v1/generate_cash_flows

Genera i piani di flussi di cassa per un insieme di strumenti ad-hoc e/o memorizzati — in batch.

curl -s https://calc.dev.emrgex.com/v1/generate_cash_flows -H 'content-type: application/json' -d '{
  "schedules": [ { "instrument_id": "MH12034" } ]
}'

GET /v1/admin/conventions

Discovery: ogni rate_type e day_count supportati dal motore, ciascuno con una descrizione, oltre al formato calculation_code. Vedi Convenzioni.

curl https://calc.dev.emrgex.com/v1/admin/conventions

GET /v1/admin/instruments

Elenca le caratteristiche degli strumenti memorizzati (nessun array di flussi di cassa a meno che with_cashflows=true; cashflow_count è sempre incluso). Tutti i filtri sono opzionali e combinati in AND.

Query param	Corrispondenza
`rate_type`, `day_count`, `calculation_code`, `currency`, `period_name`	esatta
`issuer`, `rate_kind`, `name`	sottostringa (case-insensitive)
`q`	sottostringa su id / nemo / isin / issuer / name
`amortizing`, `callable`	booleano
`maturity_from`, `maturity_to`	intervallo di date inclusivo
`coupon_min`, `coupon_max`	intervallo
`sort`	`id` · `nemo` · `issuer` · `maturity` · `coupon`
`order`	`asc` · `desc`
`limit` (≤ 1000), `offset`	paginazione; `limit=0` restituisce solo il totale
`with_cashflows`	include il piano memorizzato di ciascuno strumento

curl "https://calc.dev.emrgex.com/v1/admin/instruments?callable=true&sort=maturity&limit=10"

PATCH `/v1/admin/instruments/{id}`

Aggiorna in place il coupon_rate e/o il coupon_type di uno strumento memorizzato — ad esempio un reset a tasso variabile o una repactuação. La modifica è un override in memoria (un ricaricamento del catalogo ripristina la vista del file) e invalida la cache così che il calcolo successivo la rifletta.

curl -s -X PATCH https://calc.dev.emrgex.com/v1/admin/instruments/MH12034 \
  -H 'content-type: application/json' -d '{ "coupon_rate": 0.12 }'

POST /v1/admin/cache/reload

Ricarica il repository degli strumenti (swap atomico, non fatale).

Probe di salute

Endpoint	Scopo
`GET /v1/health/livez`	liveness (solo processo)
`GET /v1/health/readyz`	readiness (fallisce durante il draining)
`GET /v1/health/startupz`	startup (warm-load completato)

curl https://calc.dev.emrgex.com/v1/health/livez   # {"status":"alive"}

Errori

Gli errori utilizzano RFC 7807 application/problem+json con type, title, status e detail. In un batch, i fallimenti dei singoli elementi compaiono come error di quell'elemento mentre i restanti vanno a buon fine.

POST /v1/carry​

POST /v1/generate_cash_flows​

GET /v1/admin/conventions​

GET /v1/admin/instruments​

PATCH /v1/admin/instruments/{id}​

POST /v1/admin/cache/reload​

Probe di salute​

Errori​