kisnet-ytm
Retrieve Korean KIS-NET YTM Matrix data through the standalone ytm CLI or @sjunepark/ytm Node SDK. Use when requests ask for KIS-NET bond yields for a date, yield history over dates or the latest N observations, or supported bond kinds. Excludes general yield-to-maturity calculations, investment advice, other data providers, and repository maintenance.
How do I install this agent skill?
npx skills add https://github.com/cpaikr/ytm --skill kisnet-ytmIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates the retrieval of financial bond yield data using an external Node.js package and a CLI binary. While these tools are used for their stated purpose, they originate from a third-party source not identified as a trusted vendor. Additionally, the skill processes external data which presents a minor risk of indirect prompt injection.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
KIS-NET YTM
Use the standalone CLI installed from a GitHub Release. In the repository
checkout, replace ytm below with bun run cli --; this invokes the Rust/Clap
binary. The Node package is a private development SDK; the release pipeline
publishes only the CLI. For an in-process Node integration, import
YtmClient and the operation-specific validation helpers from @sjunepark/ytm.
ytm kinds --format json
ytm history --count 180 --end-date 2026-09-08 --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
- For the latest N observation dates, use
history --count N --end-date YYYY-MM-DD, with optional inclusive--start-date. Count is 1–2000; the exact backward scan stops within 2000 calendar days. Do not combine count with a date list or previous-available fallback. A shortfall raisesinsufficient_history. - A numeric yield anywhere qualifies a date; missing cells may remain. Report
requestedDates.lengthas the selected date count and preservecountSelection.availableCountcounts date/category pairs, not dates. - Dates accept
YYYY-MM-DD,YYYY.MM.DD, orYYYYMMDD. - Kind accepts a source code or Korean label. The canonical catalog includes
80회사채(사모), distinct from70회사채(무보증). - Exact-date lookup is the default. Use
previous-availableonly when the caller authorizes walking backward through calendar dates. - Date fallback runs only after confirmed unavailable data. Eligible transient transport failures retry within bounded attempt and retrieval budgets; exhausted transport failures, protocol failures, and source-format failures abort retrieval rather than selecting an earlier date.
- 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 becomenullwhile raw text remains available.
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);
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cpaikr/ytm/kisnet-ytm">View kisnet-ytm on skillZs</a>