用途：用 jquants 命令获取日本股市数据。先确定数据类别（eq、mkt、deriv、edinet、fins、idx、td），确认用户计划可用性，再用 jquants schema <endpoint> 核实字段名（勿推测），大量或全市场数据改用 bulk，最后组装命令。
认证：推荐 jquants login（浏览器 OAuth2 PKCE，自动保存 API 密钥至 ~/.config/jquants/credentials.json）；也可 export JQUANTS_API_KEY="your-api-key"。优先级为 credentials.json 的 api_key → 环境变量 → 报错并提示登录。jquants schema 无需认证。
语法：全局选项（--output、--save、-f）须放在子命令之前，如 jquants --output csv --save out.csv eq daily --code 86970。管道时自动转为 CSV；Parquet 必须配合 --save；table 与 --save 不兼容。可用 -f Date,Code,AdjustmentClose 选字段。
主要命令：eq master/daily/valuation/am/minute/investor-types/earnings-calendar/trades；mkt breakdown/margin-alert/margin-interest/calendar/short-ratio/short-sale-report；deriv futures/options/options-225；fins details/dividend/earnings-date/summary；idx daily/daily-topix；edinet 三类；td list/files/bulk。
特殊行为：eq trades 内部走批量 API，不支持 --code，须用 --date YYYY-MM，可加 --download；fins details 的 FS 字段为嵌套 JSON，须 --output json；deriv --contract-flag 1 仅取中心限月。
速率限制：Free 5、Light 60、Standard 120、Premium 500 请求/分钟；分足与 Tick 附加限制 60、TDnet 100。超限返回 HTTP 429，大幅超限约 5 分钟完全屏蔽，勿立即重试。
计划可用性：Free 支持 eq master/daily/valuation/earnings-calendar、fins summary/earnings-date、mkt calendar，且不可 CSV/批量（mkt calendar 除外）；Light 增加 eq investor-types、idx daily-topix；Standard 增加 mkt 多项、idx daily、deriv options-225、edinet 三类；Premium 增加 eq am、fins details/dividend、mkt breakdown、deriv futures/options；分足/Tick 与 td 需相应附加服务。
数据新鲜度：约 10:05、12:00、16:30、17:30、18:00、24:30、27:00（次日 3:00）分批更新，edinet 随披露更新。更新前当日数据不可得。具体期间与计划限制、批量工作流、更新排程细节见相应 references 文件；资料未提供收费价格与部分平台细节。