अन्य एंडपॉइंट
सभी एंडपॉइंट https://calc.dev.emrgex.com/v1 के अंतर्गत हैं।
POST /v1/carry
एड-हॉक और/या संग्रहीत इंस्ट्रूमेंट्स के एक पूल के लिए दैनिक कैरी (प्रभावी-ब्याज) — बैच। प्रत्येक
carries आइटम एक इंस्ट्रूमेंट को संदर्भित करता है और एक इनपुट तथा (वैकल्पिक रूप से) एक carry_to होराइज़न
देता है (खाली = अगली कूपन तिथि)।
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
एड-हॉक और/या संग्रहीत इंस्ट्रूमेंट्स के एक पूल के लिए कैशफ़्लो शेड्यूल जनरेट करें — बैच।
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
डिस्कवरी: इंजन द्वारा समर्थित प्रत्येक rate_type और day_count, प्रत्येक का एक विवरण सहित, साथ ही
calculation_code फ़ॉर्मेट। देखें कन्वेंशन।
curl https://calc.dev.emrgex.com/v1/admin/conventions
GET /v1/admin/instruments
संग्रहीत इंस्ट्रूमेंट्स की विशेषताएँ सूचीबद्ध करें (जब तक with_cashflows=true न हो, कैशफ़्लो ऐरे शामिल नहीं;
cashflow_count हमेशा शामिल रहता है)। सभी फ़िल्टर वैकल्पिक हैं और AND-संयोजित होते हैं।
| Query param | मिलान |
|---|---|
rate_type, day_count, calculation_code, currency, period_name | सटीक |
issuer, rate_kind, name | सबस्ट्रिंग (केस-असंवेदनशील) |
q | id / nemo / isin / issuer / name में सबस्ट्रिंग |
amortizing, callable | बूलियन |
maturity_from, maturity_to | समावेशी तिथि-सीमा |
coupon_min, coupon_max | सीमा |
sort | id · nemo · issuer · maturity · coupon |
order | asc · desc |
limit (≤ 1000), offset | पेजिनेशन; limit=0 केवल कुल संख्या लौटाता है |
with_cashflows | प्रत्येक इंस्ट्रूमेंट का संग्रहीत शेड्यूल शामिल करें |
curl "https://calc.dev.emrgex.com/v1/admin/instruments?callable=true&sort=maturity&limit=10"
PATCH /v1/admin/instruments/{id}
किसी संग्रहीत इंस्ट्रूमेंट के coupon_rate और/या coupon_type को यथास्थान अपडेट करें — जैसे कि फ़्लोटिंग-रेट
रीसेट या repactuação। यह परिवर्तन एक इन-मेमोरी ओवरराइड होता है (कैटलॉग रीलोड फ़ाइल
व्यू को पुनर्स्थापित कर देता है) और कैश को अमान्य कर देता है ताकि अगली गणना इसे प्रतिबिंबित करे।
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
इंस्ट्रूमेंट रिपॉज़िटरी को रीलोड करें (एटॉमिक स्वैप, नॉन-फ़ेटल)।
हेल्थ प्रोब
| Endpoint | उद्देश्य |
|---|---|
GET /v1/health/livez | लाइवनेस (केवल प्रोसेस) |
GET /v1/health/readyz | रेडीनेस (ड्रेनिंग के दौरान विफल होता है) |
GET /v1/health/startupz | स्टार्टअप (वार्म-लोड पूर्ण) |
curl https://calc.dev.emrgex.com/v1/health/livez # {"status":"alive"}
त्रुटियाँ
त्रुटियाँ RFC 7807 application/problem+json का उपयोग करती हैं, जिसमें
type, title, status, और detail होते हैं। किसी बैच में, प्रति-आइटम विफलताएँ उस आइटम के
error के रूप में प्रकट होती हैं जबकि शेष सफल होते हैं।