その他のエンドポイント

すべてのエンドポイントは 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 条件で結合されます。

クエリパラメータ	マッチ方法
`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

インストルメント・リポジトリを再読み込みします（アトミックなスワップ、非致命的）。

ヘルスプローブ

エンドポイント	用途
`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 として現れ、その他の項目は成功します。

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​

ヘルスプローブ​

エラー​