seokhoonj/krx-openapi / plugins/krx/skills/fetch
fetch
VerifiedFetch one day of KRX market data from the KRX Open API, by the same readable names the Python client uses. Holds no logic of its own -- it calls the krx-openapi package's CLI (`krx fetch <group> <name> <date>`) and shows the result to the user. Needs a group + method (find them with the list skill) and a trade date. Trigger phrases: KRX 시세 가져와, KRX 일별 데이터, 코스피 전종목 시세, KRX 지수 조회, 국채 시세, fetch KRX data, KRX daily prices, KOSPI stocks on a date, KRX index for.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
SKILL.md
View on GitHub---
name: fetch
description: "Fetch one day of KRX market data from the KRX Open API, by the same readable names the Python client uses. Holds no logic of its own -- it calls the krx-openapi package's CLI (`krx fetch <group> <name> <date>`) and shows the result to the user. Needs a group + method (find them with the list skill) and a trade date. Trigger phrases: KRX 시세 가져와, KRX 일별 데이터, 코스피 전종목 시세, KRX 지수 조회, 국채 시세, fetch KRX data, KRX daily prices, KOSPI stocks on a date, KRX index for."
---
# krx — fetch one day of a service
Take a KRX service (a `group name` pair, e.g. `index kospi`, `stock daily`) and a
trade date, and print that day's rows. The command mirrors the Python call:
`krx.index.kospi("20200414")` is `krx fetch index kospi 20200414`. The request, the
KRX status contract, and parsing live in the krx-openapi package (on PyPI); this
skill is a thin wrapper that calls its CLI and relays the result. A rejected key, an
un-applied service, or a quota error comes back as a one-line `krx: <message>` --
relay it as-is rather than throwing a stack trace.
**One date, not a range.** Every KRX endpoint is a per-date snapshot: one call
returns that whole market on that one day (all stocks, all bonds, ...), not a time
series. For a range, call once per trading day.
## Prerequisite
This plugin calls the `krx` CLI, so the package must be installed and an API key set:
```
pipx install krx-openapi # or: pip install krx-openapi
export KRX_API_KEY=... # a free key from https://openapi.krx.co.kr
```
The key can also be stored in `~/.config/krx-openapi/credentials.json` as
`{"KRX_API_KEY": "..."}`. **A key alone is not enough** -- each service must also be
applied for and approved under "서비스 이용" on the KRX account, or the call returns 401.
(The **list** and **fields** skills need no key at all -- they are offline.)
## Running
```
krx fetch <GROUP> <NAME> <YYYYMMDD> [--market M] [--json]
```
- `GROUP NAME` is the readable service pair -- `index kospi`, `stock daily`,
`bond treasury`, `derivatives futures`, `etp etf`, ... Get it from the **list**
skill (`krx list`).
- The date is a `YYYYMMDD` trade date (a past business day).
- `--market` applies only to four services (KOSPI default; case-insensitive):
`stock daily` and `stock info` take `KOSPI|KOSDAQ|KONEX`; `derivatives stock_futures`
and `derivatives stock_options` take `KOSPI|KOSDAQ` (KONEX has no stock derivatives).
Every other service rejects `--market` with a usage error (exit 2).
- `--json` emits the full rows; the text view shows an aligned table (first 20 rows)
and a total count.
## Procedure
1. **Get the `group name`.** If the user gave a concept ("코스피 지수", "국채 시세") but no
names, use the **list** skill first (`krx list`), then come back here.
2. **Pick a valid date.** KRX serves the previous business day's data from 08:00 KST
the next morning; a weekend, holiday, same-day, or pre-08:00 date returns empty
(not an error). Default to the last completed trading day.
3. **Run.**
```bash
krx fetch index kospi 20200414
krx fetch stock daily 20200414 --market KOSDAQ
```
4. **Relay the result.** Show the CLI's stdout. You may trim a long table, but keep
the count line. Use `--json` when the user wants the whole day or machine-readable
data.
5. **Error handling.** Relay the one-line `krx: <message>` from stderr as-is. Common
ones:
- `command not found: krx` -> not installed; point the user at `pipx install krx-openapi`.
- `no KRX API key ...` -> no key was found (env var and config file both empty).
- `KRX 401: ...` -> the key was rejected **or the service was not applied for**; tell
the user to apply for that API under "서비스 이용" and wait for approval.
- `KRX daily call quota exceeded ...` -> the 10,000-calls-per-key-per-day limit (429);
wait until midnight KST.
- An empty table (`(no rows)`) is not an error -- it usually means a non-trading date
or data not yet published; suggest an earlier business day.
## What this skill does not do
- It does not re-implement fetching or parsing (the package does); it always calls the CLI.
- It returns one day of one service -- to discover the groups and methods use the
**list** skill, and for a service's columns use the **fields** skill. It cannot
return investor trading, short selling, PER/PBR, adjusted prices, or intraday data
(the KRX Open API does not serve those).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |