✨ feat(tsl-api-reference): add class and framework API lookup

2026-08-20 13:49:55 +08:00
parent 7233646398
commit 651c1f68d2
637 changed files with 25498 additions and 36673 deletions
@@ -0,0 +1,260 @@
+# 应用专题 / 因子研究 / 筹码因子模型
+
+## `ts_ChipDistribution`
+
+声明：class
+
+通过可重写的数据输入接口计算证券筹码分布、获利比例、收益和分布形态指标
+
+<!-- tags: 筹码分布 因子模型 技术因子 -->
+
+### `FBegT`
+
+声明：field
+
+筹码测算开始日，默认从当前日期向前推 60 日
+
+可见性：`public`
+
+类型：datetime
+
+### `FEndT`
+
+声明：field
+
+筹码测算截止日，默认 `today()-1`
+
+可见性：`public`
+
+类型：datetime
+
+### `FStockID`
+
+声明：field
+
+证券代码，使用基类时必须设置
+
+可见性：`public`
+
+类型：string
+
+### `GetTradeDaysArr()`
+
+声明：function
+
+返回测算区间的交易日序列；使用基类时需重写
+
+可见性：`public`
+
+返回：array
+
+### `GetTradeDataByEndT(v_end_t)`
+
+声明：function
+
+返回指定日的价格、比例和成交金额分布；使用基类时需重写
+
+可见性：`public`
+
+| 参数      | 类型     | 说明   |
+| --------- | -------- | ------ |
+| `v_end_t` | datetime | 截止日 |
+
+返回：array
+
+### `GetCloseByEndT(v_end_t)`
+
+声明：function
+
+返回指定日收盘价；使用基类时需重写
+
+可见性：`public`
+
+| 参数      | 类型     | 说明   |
+| --------- | -------- | ------ |
+| `v_end_t` | datetime | 截止日 |
+
+返回：real
+
+### `GetHslByEndT(v_end_t)`
+
+声明：function
+
+返回指定日换手率；使用基类时需重写
+
+可见性：`public`
+
+| 参数      | 类型     | 说明   |
+| --------- | -------- | ------ |
+| `v_end_t` | datetime | 截止日 |
+
+返回：real
+
+### `ChipMeasure()`
+
+声明：function
+
+执行筹码因子计算总流程
+
+可见性：`public`
+
+返回：nil
+
+### `ChipDistribution()`
+
+声明：function
+
+返回价格、留存金额、留存比例、筹码比例和相对收益率构成的筹码分布
+
+可见性：`public`
+
+返回：array
+
+### `ChipWinPercent()`
+
+声明：function
+
+返回获利筹码比例
+
+可见性：`public`
+
+返回：real
+
+### `ChipReturn_FixedQK()`
+
+声明：function
+
+返回筹码收益率，也称筹码均值
+
+可见性：`public`
+
+返回：real
+
+### `CumulativeChipProfit()`
+
+声明：function
+
+返回累积筹码收益
+
+可见性：`public`
+
+返回：real
+
+### `ChipVRC()`
+
+声明：function
+
+返回筹码分布方差
+
+可见性：`public`
+
+返回：real
+
+### `ChipSRC()`
+
+声明：function
+
+返回筹码分布偏度
+
+可见性：`public`
+
+返回：real
+
+### `ChipKRC()`
+
+声明：function
+
+返回筹码分布峰度
+
+可见性：`public`
+
+返回：real
+
+## `ts_IndexChipDistribution`
+
+声明：class
+
+在筹码因子基类之上封装指数价格和换手率数据输入的指数筹码计算框架
+
+<!-- tags: 指数筹码 指数因子 筹码分布 -->
+
+父类：`ts_ChipDistribution`
+
+### `FIndexID`
+
+声明：field
+
+指数代码，默认 `SH000001`
+
+可见性：`public`
+
+类型：string
+
+### `FEndT`
+
+声明：field
+
+筹码测算截止日，默认 `today()-1`
+
+可见性：`public`
+
+类型：datetime
+
+### `FNDay`
+
+声明：field
+
+测算交易日数，默认 60
+
+可见性：`public`
+
+类型：integer
+
+### `FPriceType`
+
+声明：field
+
+指数均价算法；支持算术平均、成交量加权、成交金额加权及调整后的成交量加权
+
+可见性：`public`
+
+类型：integer
+
+### `FRightType`
+
+声明：field
+
+换手率加权方式；0 为加权算法，非 0 为算术平均
+
+可见性：`public`
+
+类型：integer
+
+## `Index_TA_ChipDistribution(index_id, end_t, days, price_type, right_type, stype)`
+
+声明：function
+
+计算指定指数的筹码分布指标
+
+<!-- tags: 指数 筹码分布 因子指标 -->
+
+| 参数         | 类型     | 说明                           |
+| ------------ | -------- | ------------------------------ |
+| `index_id`   | string   | 指数代码                       |
+| `end_t`      | datetime | 截止日                         |
+| `days`       | integer  | 测算交易日数                   |
+| `price_type` | integer  | 指数均价算法类型               |
+| `right_type` | integer  | 换手率加权方式                 |
+| `stype`      | integer  | 换手率股票类型；0 全部，1 A 股 |
+
+返回：array
+
+## `chipDistribution_test()`
+
+声明：function
+
+通过临时派生类重写四个数据输入方法，演示筹码因子基类的调用流程
+
+<!-- tags: 筹码分布 基类 调用范例 -->
+
+返回：array