openstock/skills/openstock-agent-cli/references/commands/api/login/guide.md

openstock api login

Purpose: issue or reuse a KIS live API access token.

Usage:

openstock api login
openstock api login --force
openstock api login --appkey KEY --appsecret SECRET

Inputs: optional --appkey, --appsecret, --force.

Reads: KIS_APPKEY, KIS_APPSECRET, existing token values.

Writes: ~/.config/openstock/.env token state.

Output fields: broker, status, force, credential_source, token_storage, side_effect.

Agent rule: do not force refresh unless the user asks or an API call fails because the token is invalid.