शुरुआत करना

बेस URL और परिपाटियाँ (conventions)

Base URL	https://calc.dev.emrgex.com
Prefix	प्रत्येक endpoint /v1 के अंतर्गत है
दरें और प्रतिफल (yields)	दशमलव में — 0.06 का अर्थ है 6%
कीमतें	अंकित मूल्य (face value) के प्रति 100 पर
तिथियाँ	ISO YYYY-MM-DD
Content type	application/json

आपका पहला अनुरोध (request)

किसी संग्रहित (stored) उपकरण की कीमत निकालें — उसे instrument_id द्वारा संदर्भित करें और एक प्रतिफल (yield) दें:

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 } }
    ]
  }'

प्रतिक्रिया (response) एक बैच एनवेलप (batch envelope) होती है — प्रति quote एक प्रविष्टि, प्रत्येक का अपना status होता है:

{
  "data": [
    {
      "index": 0,
      "id": "MH12034",
      "status": "ok",
      "data": {
        "instrument_id": "MH12034",
        "convention": "NOMINAL · ACT/ACT.DRMH",
        "calculation_code": "ACT/ACT.DRMH|NOMINAL",
        "metrics": {
          "yield": 0.1,
          "dirty_price": 112.547645,
          "clean_price": 107.853124,
          "accrued_interest": 4.694521,
          "modified_duration": 5.12,
          "convexity": 33.7,
          "dv01": 0.0576
        }
      }
    }
  ]
}

प्रतिफल के बजाय कीमत द्वारा मूल्यांकन

input_kind को clean_price या dirty_price पर सेट करें और emrgex आपके लिए प्रतिफल (yield) हल कर देता है:

{ "instrument_id": "MH12034", "input_kind": "clean_price", "input_value": 107.85,
  "settlement_date": "2026-06-09", "options": { "round": 6 } }

अपना स्वयं का बॉन्ड परिभाषित करें (ad-hoc)

उपकरण को instruments में इनलाइन रखें, फिर quotes से उसके id को संदर्भित करें:

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 } }
    ]
  }'

एक ट्रेड आकार (trade size) जोड़ें

मुद्रा संबंधी आँकड़े (निपटान राशियाँ / settlement amounts) प्रति-100 कीमतों के साथ प्राप्त करने के लिए एक amount प्रदान करें:

{ "instrument_id": "MH12034", "input_kind": "yield", "input_value": 0.10,
  "amount_kind": "nominal", "amount_value": 1000000,
  "settlement_date": "2026-06-09", "options": { "round": 6 } }

स्वास्थ्य जाँच (health check)

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

:::tip Performance थोक में मूल्यांकन करने के लिए, एक ही /v1/quotes अनुरोध में कई quotes भेजें (एक बैच)। जब तक आपको प्रत्येक बॉन्ड का शेड्यूल न चाहिए, with_cashflows को बंद रखें — इससे प्रतिक्रियाएँ काफी छोटी और तेज़ हो जाती हैं। :::

:::note Authentication विकास सेवा (development service) वर्तमान में खुली है (कोई API key नहीं)। उत्पादन परिनियोजन (production deployments) HMAC अनुरोध हस्ताक्षरण (request signing) सक्षम कर सकते हैं। :::