证券代码带交易所后缀
股票代码使用 600519.SH、000001.SZ、430047.BJ 等形式；指数、ETF 与外汇保留各自命名空间。
规范化原则
交易日不等于报告期
日期统一使用 YYYYMMDD。财务接口在上游记录提供时区分报告期、公告日期和实际披露日期。
数值保持数值类型
价格、成交量、比率与金额在可用时返回 JSON 数值；Python SDK 将记录映射为 pandas DataFrame，不自行创造数据。
空值本身也是信息
不可用或不适用字段保持 null。除非接口明确规定，QuantCoda 不会前向填充财务事实，也不会把缺失观察替换为零。
更新频率与发布时间
更新节奏由接口决定：日行情跟随已完成交易日，财务记录跟随公司披露，实时与快讯接口携带各自观察时间。判断新鲜度时应检查返回日期字段，而不是只看请求时间。
“实时”描述接口类别，不单独承诺交易所直连延迟；网络、上游发布时间、市场交易时段和套餐权限都可能影响可用性。
历史修订与可复现性
- 上游更正可能改变历史记录；重要研究应保留获取时间并允许重新运行。
- API v1 内只进行向后兼容扩展，例如新增可选参数、端点或返回字段。
- 破坏性变更使用并行新版本，并发布迁移说明。
- 研究结果应记录接口、参数、获取时间和对应交易日或报告期。
质量检查与用户责任
QuantCoda 围绕公开契约执行 schema、类型、必填参数和响应结构检查。这些检查可以减少接入错误，但不能代替针对具体研究用途的数据验证。发现疑似问题时，请将接口、证券代码、相关日期和最小可复现请求发送至 support@quantcoda.com。