Strumenti: registrati vs ad-hoc

emrgex distingue gli strumenti registrati da quelli ad-hoc in base a una sola cosa: se il titolo è già presente nel catalogo.

	Dove è definito	Schema dei flussi di cassa	Valutazione
Registrati	nel catalogo (riferimento tramite id)	persistito (lo schema dell'emittente)	ricalcolata a ogni chiamata
Ad-hoc	inline nella tua richiesta	generato dalle caratteristiche	ricalcolata a ogni chiamata

In entrambi i casi, prezzi, rendimenti, duration, convessità e rateo non vengono mai memorizzati — sono ricalcolati dallo schema a ogni richiesta, secondo la convenzione dello strumento.

Campi dello strumento

Quando definisci uno strumento ad-hoc (o ne ispezioni uno registrato), questi sono i campi:

Campo	Obbligatorio	Note
id	sì (ad-hoc)	il tuo riferimento per lo strumento nella richiesta
rate_type	sì	NOMINAL / EFFECTIVE / AT_MATURITY / PRICE_QUANTITY
day_count	sì¹	nome FpML/ISDA; non utilizzato per PRICE_QUANTITY
coupon_type	no	FIXED (predefinito) o ACCRUAL
frequency	sì²	cedole per anno
start	sì	data di emissione / primo rateo
maturity	sì
coupon_rate	no	cedola annua come decimale (0.06 = 6%)
face_value	sì	di solito 100
unit_nominal	no	taglio minimo negoziabile; arrotonda un nominale derivato
eom	no	rolling a fine mese
ex_div_days	no	giorni di stacco cedola (ex-dividend)
amortizations	no	array di { date, amount } — vedi sotto
calls	no	array di { date, price } — rende il titolo rimborsabile anticipatamente (callable)

¹ Obbligatorio tranne per PRICE_QUANTITY. ² AT_MATURITY / PRICE_QUANTITY forzano frequency a 1.

Titoli con ammortamento

Aggiungi un array amortizations di { date, amount } (capitale rimborsato per ciascuna data). I titoli con ammortamento sono quotati sul nominale residuo corrente (lo standard di mercato): prezzi e DV01 si scalano sulla frazione residua, mentre duration, convessità e rendimenti sono invarianti rispetto alla scala. Un amount_value fornito viene interpretato come il nominale residuo corrente.

Titoli callable

Aggiungi un array calls di { date, price } (prezzo di rimborso per 100 di nominale). Quando quoti un titolo callable tramite prezzo, imposta options.yield_worst: true per ricevere anche lo yield-to-worst (il min tra yield-to-maturity e ciascun yield-to-call). Vedi Metriche.

Esplorazione del catalogo registrato

# list instruments (filterable, paginated)
curl "https://calc.dev.emrgex.com/v1/admin/instruments?issuer=Hacienda&limit=20"

Filtri utili (tutti opzionali, combinati in AND): rate_type, day_count, calculation_code, currency, issuer (sottostringa), name (sottostringa), q (cerca in id/nemo/isin/issuer/name), amortizing, callable, maturity_from / maturity_to, coupon_min / coupon_max, più sort, order, limit, offset. limit=0 restituisce solo il conteggio totale. Vedi il riferimento API.