法定交易费用规则

数据集标识：ref.fee_rules；证券对象标识示例：000001.SZ

按「场所 × 资产类别 × 子类 × 板块 × 品种 × 生效区间」的法定交易费用：印花税、交易所经手费、监管费与过户费，不含券商佣金。同一时点多种费用同时生效，每个「费用类型 × 买卖方向」恰好一条；表中没有的费用类型表示尚未登记，不表示免收。

业务主键：rule_id，每行取值唯一。

接口

用途	方法与路径
查询数据	`POST /v1/datasets/ref.fee_rules/query`
契约与当前发布	`GET /v1/datasets/ref.fee_rules`
准备批量快照	`POST /v1/datasets/ref.fee_rules/preparations`

请求参数

可在请求体 where 中作为 field 使用的筛选参数，名称保持契约原名。

参数名	类型	必填	说明
`start_date`	`date`	否	按生效日期筛选，查询开始日期，包含该日。
`end_date`	`date`	否	按生效日期筛选，查询结束日期，包含该日。

返回字段

列名保持契约原名，可直接用于 select、where 与结果行。

字段名	中文名称	类型	可空	说明
`rule_id`	规则标识	`string`	否	规则在本数据集内的唯一标识，以场所码小写开头、以生效起始年份结尾。
`venue`	场所	`string`	否	交易场所码：ISO 10383 MIC（如 XSHG 上海证券交易所），无 MIC 的场所用 BQ 开头的登记码。
`asset_class`	资产类别	`string`	否	资产类别登记值，如 stock 股票、etf 交易型开放式基金。
`asset_subclass`	资产子类	`string`	是	资产子类登记值，如 ETF 的 equity、growth_board_equity、bond、money_market、commodity、cross_border；为空表示适用该类别全部子类。
`market_segment`	板块	`string`	是	场所内的板块登记值，如 main 主板、star 科创板、chinext 创业板、sme 中小企业板、bse 北京证券交易所；为空表示不限板块。
`product_code`	品种代码	`string`	是	衍生品所属品种的场所代码；为空表示不限品种。
`instrument_set_id`	标的集合标识	`string`	是	规则适用的标的集合标识（ref.instrument_sets）；规则只对当日属于该集合的标的生效，为空表示不限。范围其余字段相同、引用同一集合族内不同集合的两条规则不算重叠。
`valid_from`	生效日期	`date`	否	规则生效日，包含该日。
`valid_to`	失效日期	`date`	是	规则失效日，不含该日；为空表示至今有效。
`fee_type`	费用类型	`string`	否	费用类型登记值：stamp_duty 印花税，exchange_handling 交易所经手费，regulatory 监管费，transfer 过户费。
`side`	收取方向	`string`	否	buy 买方，sell 卖方，both 买卖双方。
`fee_basis`	计费基础	`string`	否	notional 成交金额，quantity 成交数量，contract 合约张数，order 笔数。
`fee_rate`	费率	`decimal`	是	按计费基础计的费率，0.0005 即 0.05%；按固定金额收取时为空。
`fee_amount`	固定金额	`decimal`	是	每单位计费基础的固定金额；按费率收取时为空。
`min_fee_amount`	最低金额	`decimal`	是	单笔最低收取金额；没有下限时为空。
`max_fee_amount`	最高金额	`decimal`	是	单笔最高收取金额；没有上限时为空。
`fee_currency`	费用币种	`string`	否	费用金额的币种。
`basis_document`	依据文件	`string`	否	规则依据的业务规则名称与条款摘要。
`evidence_sha256`	依据原件哈希	`string`	是	依据原件内容的 sha256；尚未取得原件时为空。
`verification_status`	核验状态	`string`	否	verified 已有依据原件，unverified 尚未取得依据原件。
`rules_version`	规则表版本	`string`	否	规则表全部内容的 sha256；规则表变化即版本变化，已发布数据不随之改变。

字段补充属性

括号中是契约描述（GET /v1/datasets/{datasetId} 的 fields）里的键名。

字段名	属性
`venue`	标准（`standard`）：ISO 10383
`side`	枚举（`allowedValues`）：["buy", "sell", "both"]
`fee_basis`	枚举（`allowedValues`）：["notional", "quantity", "contract", "order"]
`fee_rate`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：ratio
`fee_amount`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:fee_currency
`min_fee_amount`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:fee_currency
`max_fee_amount`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:fee_currency
`fee_currency`	标准（`standard`）：ISO 4217
`verification_status`	枚举（`allowedValues`）：["verified", "unverified"]

请求示例

向 https://api.<环境域名>/v1/datasets/ref.fee_rules/query 发送 POST 请求（服务地址的替换方式见快速开始），请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json，请求体如下：

{
  "select": [
    "venue",
    "asset_class",
    "valid_from",
    "fee_type",
    "side",
    "fee_rate"
  ],
  "where": [
    {
      "field": "venue",
      "op": "eq",
      "value": "XSHG"
    },
    {
      "field": "valid_from",
      "op": "gte",
      "value": "2023-08-28"
    },
    {
      "field": "valid_from",
      "op": "lte",
      "value": "2023-08-28"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例

实际结果随数据更新而变化；data 为空数组表示请求范围内没有可返回的记录。

{
  "datasetId": "ref.fee_rules",
  "fields": [
    "venue",
    "asset_class",
    "valid_from",
    "fee_type",
    "side",
    "fee_rate"
  ],
  "data": [
    {
      "asset_class": "stock",
      "fee_rate": "0.000500000000000000",
      "fee_type": "stamp_duty",
      "side": "sell",
      "valid_from": "2023-08-28",
      "venue": "XSHG"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}

接口​

请求参数​

返回字段​

字段补充属性​

请求示例​

响应示例​

接口

请求参数

返回字段

字段补充属性

请求示例

响应示例