cpaikr/ytm

kisnet-ytm

Use when retrieving Korean KIS-NET YTM Matrix rows or listing supported bond kinds through the standalone ytm CLI or @sjunepark/ytm Node SDK.

ソースを見る
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

KIS-NET YTM

Publication is not yet authorized. In the repository checkout, replace ytm below with bun run cli --; this invokes the standalone Rust/Clap binary. The Node package is SDK-only. For an in-process Node integration, import YtmClient and the operation-specific validation helpers from @sjunepark/ytm.

sh
ytm kinds --format json
ytm matrix --base-date 2026-06-08 --kind 국채 --format json --pretty
ytm matrix --base-date 2026-06-07 --kind 80 --fallback previous-available --lookback-days 10 --format json
  • Dates accept YYYY-MM-DD, YYYY.MM.DD, or YYYYMMDD.
  • Kind accepts a source code or Korean label. The canonical catalog includes

80 회사채(사모), distinct from 70 회사채(무보증).

  • Exact-date lookup is the default. Use previous-available only when the

caller authorizes walking backward through calendar dates.

  • Retry fallback only after confirmed unavailable data. Transport, protocol,

and source-format failures stop immediately.

  • JSON is the default agent-readable output. Execution and invalid-invocation

failures are structured JSON; inspect their recovery metadata before retrying. ytm help <unknown> instead prints a plain-text help error and exits with status 2.

  • Report requested and resolved dates, kind, tenors, and rows by 적용대상채권.

Source - or empty yields become null while raw text remains available.

js
import { YtmClient, validateMatrixInput } from "@sjunepark/ytm";

const client = new YtmClient();
const validation = validateMatrixInput({
  baseDate: "2026-06-08",
  kind: "회사채(사모)"
});
if (!validation.ok) throw validation.error;
const result = await client.matrix(validation.input);