toki/alt
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
alt/services/worker/testdata/providers/kis/README.md
toki f38cbbc5cb feat(marketdata): KIS 미국장 일봉 수집을 추가한다 
미국장 일봉 import가 국내 KIS chart endpoint에 묶여 있으면 NASDAQ/NYSE 요청을 정상화된 USD bar로 저장할 수 없다. provider capability로 venue/timeframe 지원 여부를 먼저 검증하고, KIS overseas dailyprice 응답을 venue timezone과 USD 통화 기준으로 normalize하도록 경로를 분리한다.
2026-06-06 17:54:52 +09:00

1.9 KiB
Raw Permalink Blame History

KIS Provider Fixtures

This directory is the landing zone for KIS mock-provider fixtures used by worker adapter tests and mapping work.

Source Reference

Use the locally cached official KIS sample repository first:

  • .agent-cache/koreainvestment/open-trading-api

The first daily-bar mapping reference is:

  • examples_llm/domestic_stock/inquire_daily_itemchartprice/inquire_daily_itemchartprice.py
  • examples_llm/kis_auth.py
  • kis_devlp.yaml
  • stocks_info/

Postman exports are not required for the current milestone now that the official API sample repo is available locally.

Mock Test Fixtures

Keep fixtures small, deterministic, and secret-free. The current minimum set is:

  • daily_itemchartprice_request.sample.json: KIS domestic daily chart request parameters.
  • daily_itemchartprice_response.sample.json: KIS-like domestic response payload with output1 metadata and output2 OHLCV rows.
  • daily_bars_normalized.expected.json: expected normalized KR/KRX daily bars used by worker tests.
  • overseas_dailyprice_request.sample.json: KIS overseas dailyprice (해외주식 기간별시세) request parameters for a US symbol.
  • overseas_dailyprice_response.sample.json: KIS-like overseas response payload with the xymd/clos field names the overseas endpoint uses.
  • overseas_daily_bars_normalized.expected.json: expected normalized US/NASDAQ daily bars (USD, America/New_York timestamps).
  • provider_symbols.sample.json: provider symbol metadata for watchlist, exchange-wide, and sector-like selector tests.

Sanitization

Before committing fixtures, remove:

  • app keys, app secrets, access tokens, refresh tokens, approval keys
  • account numbers or personal identifiers
  • live authorization headers
  • local hostnames or machine-specific paths
  • secret-store item references

Runtime credentials are not required for mock tests. Later live KIS smoke tests should inject credentials at runtime from SOPS-decrypted environment variables only.