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.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/cpaikr/ytm --skill kisnet-ytm

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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);

Related by task