# 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 daily chart request parameters.
- `daily_itemchartprice_response.sample.json`: KIS-like response payload with `output1` metadata and `output2` OHLCV rows.
- `daily_bars_normalized.expected.json`: expected normalized daily bars used by worker tests.
- `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
- 1Password secret references or item names

Runtime credentials are not required for mock tests. Later live KIS smoke tests should inject credentials at runtime through 1Password CLI or a later secret-provider implementation.