# 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.
