发布日期:2026-10-30 · 下载
ApiError 按平台错误码分派 AuthError(401)、BalanceError(402)、RateLimitError(429,携带服务端 Retry-After 建议秒数)、NotFoundError、ParamError、ServerError、NetworkError 七个子类;存量 except ApiError 代码不受影响pro.bar():前复权/后复权 + 均线(tushare pro_bar 同款体验,因子取自 stock_adj_factor 端点;平台与 tushare 价格列名双适配)fetch_all()/iterate():服务端 count 驱动全量拉取,max_rows 默认 10 万行保护,防止忘传区间参数时误拉全表消耗额度pro.calendar():一次拉取常驻内存,上一交易日沿服务端 pretrade_date 链行走,区间外查询明确报错(不做节假日近似)validate=off/warn/strict:烧入 33 个在售端点的参数快照,拼写错的参数在请求前暴露(schema 外参数会被服务端静默丢弃,导致全表查询)cache=True:sqlite 存储,同参数重复查询零请求零扣费;token 自动发现(环境变量 AGUSHUJU_TOKEN 或 ~/.agushuju/token)agu 命令行:query / fetch / endpoints / schema / health / token / calendar 七个子命令,fetch 支持自动翻页全量导出 CSV/JSONAsyncDataApi(httpx,pip install agushuju[async]):与同步版共用方言翻译、错误分派与重试策略query() 返回契约不变,存量代码零改动升级RateLimitError.retry_after 携带,服务端 429 响应已附带 Retry-After 头agushuju-mcp 0.1.2:限流错误单独处置(提示等待秒数),依赖下限升至 agushuju>=0.3.0