港股通成交统计

文档 v1.0.67 · 发布快照 1.0.78下载 meoz Skill最新文档

根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。

正式接口 · meoz 接口目录

查询港股通每日买入、卖出成交金额和成交笔数。金额单位为元,成交笔数单位为笔。

交易日盘后更新

历史覆盖:2023-07-11 至今(近3年)

仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。

接口名称 southbound_daily

请求方法 POST /api

  • https://hist.meoz.cn:6688
  • https://hist-vip.meoz.cn:6688

返回字段

字段 名称 类型 描述 单位
trade_date string 交易日期,格式 YYYYMMDD
buy_amount number|null 买入成交金额;单位:元
buy_volume number|null 买入成交笔数;单位:笔;单位:笔。 笔
sell_amount number|null 卖出成交金额;单位:元
sell_volume number|null 卖出成交笔数;单位:笔;单位:笔。 笔

请求

{"content":{"application/json":{"example":{"apikey":"","apiname":"southbound_daily","fields":"trade_date,buy_amount,buy_volume,sell_amount,sell_volume","params":{"enddate":"20260710","startdate":"20260611"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"southbound_daily","description":"接口名称","enum":["southbound_daily"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"trade_date,buy_amount,buy_volume,sell_amount,sell_volume","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `trade_date` | `string` | 交易日期 | `20260724` | 交易日期,格式 YYYYMMDD |\n| `buy_amount` | `number\\|null` | 买入成交金额(元) | `100000000.25` | 买入成交金额 |\n| `buy_volume` | `number\\|null` | 买入成交笔数(笔) | `1.23` | 买入成交笔数;单位:笔;单位:笔。 |\n| `sell_amount` | `number\\|null` | 卖出成交金额(元) | `100000000.25` | 卖出成交金额 |\n| `sell_volume` | `number\\|null` | 卖出成交笔数(笔) | `1.23` | 卖出成交笔数;单位:笔;单位:笔。 |"},"params":{"additionalProperties":false,"default":{"enddate":"20260710","startdate":"20260611"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `tradedate` | `string` | 可选 | `20260724` | 查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 |\n| `startdate` | `string` | 可选 | `20260701` | 查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 |\n| `enddate` | `string` | 可选 | `20260724` | 查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 |","properties":{"enddate":{"description":"查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。","example":"20260724","pattern":"^\\d{8}$","type":"string"},"startdate":{"description":"查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。","example":"20260701","pattern":"^\\d{8}$","type":"string"},"tradedate":{"description":"查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。","example":"20260724","pattern":"^\\d{8}$","type":"string"}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `southbound_daily` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}

响应

{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"矩阵型返回数据","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["trade_date","buy_amount","buy_volume","sell_amount","sell_volume"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条记录","example":[["20260724",100000000.25,1.23,100000000.25,1.23]],"items":{"items":{},"type":"array"},"type":"array"}},"required":["fields","items"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}