मेट्रिक्स और कैलकुलेशन आउटपुट
यह पेज उन मेट्रिक्स का वर्णन करता है जो कैलकुलेशन इंजन प्रत्येक बॉन्ड वैल्यूएशन के लिए लौटाता है, और बताता है कि इनकी गणना कैसे की जाती है।
ओवरव्यू
जब आप कोई कैलकुलेशन रिक्वेस्ट सबमिट करते हैं, तो इंजन एक result ऑब्जेक्ट लौटाता है जिसमें इंस्ट्रूमेंट के लिए कंप्यूट की गई सभी मेट्रिक्स होती हैं। आप किस मेट्रिक्स की उम्मीद करें, यह आपके द्वारा भेजे गए input_kind और इंस्ट्रूमेंट के rate_type पर निर्भर करता है।
सभी मॉनेटरी वैल्यू इंस्ट्रूमेंट की सेटलमेंट करेंसी में लौटाई जाती हैं। प्राइस वैल्यू फेस वैल्यू के 100 प्रति यूनिट के रूप में व्यक्त की जाती हैं, जब तक कि अन्यथा न बताया गया हो।
कोर मेट्रिक्स
| फ़ील्ड | विवरण |
|---|---|
clean_price | संचित ब्याज (accrued interest) को शामिल किए बिना प्राइस। |
dirty_price | संचित ब्याज सहित प्राइस (इसे "डर्टी" या "फुल" प्राइस भी कहा जाता है)। |
accrued_interest | पिछली कूपन तारीख से सेटलमेंट तक का जमा हुआ ब्याज। |
yield | इंस्ट्रूमेंट की यील्ड टू मैच्योरिटी, जो डेसिमल के रूप में व्यक्त की जाती है। |
dirty_price और clean_price के बीच का संबंध हमेशा बना रहता है:
dirty_price = clean_price + accrued_interest
प्राइस बनाम यील्ड
इंजन या तो प्राइस से यील्ड सॉल्व कर सकता है या यील्ड से प्राइस — यह आपके input_kind पर निर्भर करता है।
- जब
input_kindPRICE_QUANTITYहोता है, तो इंजन यील्ड को इनपुटclean_priceसे सॉल्व करता है। - जब आप कोई यील्ड सप्लाई करते हैं, तो इंजन उस यील्ड से प्राइस की गणना करता है।
यदि आप किसी पोर्टफोलियो को री-प्राइस कर रहे हैं, तो प्रत्येक इंस्ट्रूमेंट के लिए स्थिर day_count कन्वेंशन का उपयोग करना आमतौर पर तेज़ होता है, बजाय इसके कि आप पोजीशन-दर-पोजीशन इसमें बदलाव करें।
रेट टाइप के अनुसार मेट्रिक्स
लौटाई गई मेट्रिक्स इस बात पर निर्भर करती हैं कि इंस्ट्रूमेंट का rate_type NOMINAL, EFFECTIVE, या AT_MATURITY है या नहीं।
NOMINAL और EFFECTIVE इंस्ट्रूमेंट
कूपन-बेयरिंग इंस्ट्रूमेंट्स के लिए, इंजन पूरा मेट्रिक्स सेट लौटाता है, जिसमें ड्यूरेशन और कन्वेक्सिटी के मेज़र शामिल हैं:
| फ़ील्ड | विवरण |
|---|---|
macaulay_duration | कैशफ़्लो प्राप्त होने तक का वेटेड-एवरेज समय, जो वर्षों में होता है। |
modified_duration | यील्ड में परिवर्तन के प्रति प्राइस की संवेदनशीलता (price sensitivity)। |
convexity | ड्यूरेशन से प्राइस-यील्ड संबंध के कर्वेचर (वक्रता) का दूसरे क्रम का मेज़र। |
dv01 | यील्ड में एक बेसिस पॉइंट के परिवर्तन पर प्राइस में होने वाला डॉलर मूल्य का बदलाव। |
AT_MATURITY इंस्ट्रूमेंट
ज़ीरो-कूपन और डिस्काउंट इंस्ट्रूमेंट्स के लिए, जो AT_MATURITY पर सेटल होते हैं, इंजन एक घटाया हुआ सेट लौटाता है। चूँकि कोई इंटरमीडिएट कूपन नहीं होते, इसलिए macaulay_duration मैच्योरिटी तक के समय के बराबर होती है, और convexity को छोड़ा जा सकता है।
कैशफ़्लो
यदि आप अपनी रिक्वेस्ट options में with_cashflows फ़्लैग सेट करते हैं, तो इंजन रिज़ल्ट में एक पूरा कैशफ़्लो शेड्यूल जोड़ता है:
{
"options": {
"with_cashflows": true
}
}
प्रत्येक कैशफ़्लो एंट्री में पेमेंट डेट, कूपन अमाउंट, और प्रिंसिपल कंपोनेंट शामिल होता है। amount_kind फ़ील्ड दर्शाता है कि कोई एंट्री कूपन पेमेंट को रिप्रेज़ेंट करती है या प्रिंसिपल रीडेम्प्शन को।
कैशफ़्लो शेड्यूल इंस्ट्रूमेंट के day_count कन्वेंशन का सम्मान करता है। उदाहरण के लिए, ACT/ACT.ICMA के तहत शेड्यूल किया गया कोई बॉन्ड और BUS/252 के तहत शेड्यूल किया गया कोई बॉन्ड अलग-अलग संचय (accrual) अवधियाँ उत्पन्न करेंगे, भले ही उनकी नोमिनल मैच्योरिटी डेट्स एक जैसी हों।
डे काउंट कन्वेंशन
day_count कन्वेंशन यह नियंत्रित करता है कि अवधियों के बीच ब्याज कैसे संचित (accrue) होता है। समर्थित कन्वेंशन में शामिल हैं ACT/ACT.ICMA, BUS/252, और ACT/ACT.DRMH। अधिक जानकारी के लिए कन्वेंशन्स गाइड देखें।
और देखें
- कैलकुलेशन रिक्वेस्ट को कैसे स्ट्रक्चर करें, यह जानने के लिए रिक्वेस्ट स्ट्रक्चर।
- उपलब्ध
calculation_codeवैल्यूज़ की सूची के लिए कैलकुलेशन कोड्स।