异常与缓存

异常

exception libfinance.client.RpcError(code, message, kind=None)

RPC 调用错误，包含错误码和消息。

kind 是服务端给出的错误类别（CoverageError、UnknownInstrumentError……）， 旧服务端不给时为 None。

服务端拒绝了这次调用。code 是错误码，message 是原因。

exception libfinance.api.calendar.CalendarCoverageError

查询落在 release 确认过的区间之外。

这不是”那天没有交易”——是没人发布过那一天，所以任何答案都是猜的。宁可报错， 也不要让调用方拿到一个悄悄变短的结果。

缓存

参考数据（证券主数据、交易日历、行业分类等）会在客户端缓存，并在服务端数据更新时 自动失效，所以反复调用是廉价的，你不需要自己包一层缓存。

需要强制重新拉取时（一般只在排查问题时用到）：

>>> from libfinance.utils.cache import clear_all
>>> clear_all()