shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 其它需要 API Key

雪球网信息获取

从雪球获取组合、用户、行情、调仓历史等投资数据时调用此技能。

person作者: user_6eb4c6c0hubcommunity
download下载资源包

雪球数据接口技能

概述

此技能用于调用雪球数据接口，获取股票组合、用户信息、行情数据等投资相关数据。

接口基础信息

  • Base URL：
    • 本地环境：http://localhost:8080/wxpublic_fetch
    • 线上环境：https://wxpub.xiongweixp.tech
  • 请求方式：POST
  • 请求体格式：JSON
  • 鉴权：需要 app_id 和 secure_key（在「Skill 技能」页面创建）
  • 计费：每次成功调用扣 0.2 元；失败自动退款，余额不足返回 402
  • 限速：60秒内最多10次上游请求（所有用户共享）

公共请求字段

所有接口都必须包含以下字段：

| 字段 | 类型 | 说明 | |---|---|---| | app_id | string | 申请的 AppID | | secure_key | string | 对应的 SecureKey |

凭证设置提醒

如果用户未设置 AppID 及 SecureKey：

请先前往 https://wxpub.xiongweixp.tech 注册账号，在「Skill 技能」页面获取 app_id 和 secure_key。

可用接口

一、搜索类接口

1.1 searchUser — 搜索用户

用途：根据关键词搜索雪球用户

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "keyword": "天地侠影",
  "count": 10,
  "page": 1
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | keyword | string | 必填 | 搜索关键词 | | count | int | 10 | 每页条数 | | page | int | 1 | 页码 |

返回字段：用户ID、昵称、粉丝数、简介等

1.2 searchCube — 搜索组合

用途：根据关键词搜索投资组合

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "keyword": "实盘",
  "count": 10,
  "page": 1
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | keyword | string | 必填 | 搜索关键词，如「实盘」「量化」 | | count | int | 10 | 每页条数 | | page | int | 1 | 页码 |

返回字段：组合ID、代码、名称、总收益、年化收益、净值等

1.3 searchStatus — 搜索帖子

用途：根据关键词搜索雪球帖子

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "keyword": "散户老牛",
  "count": 10,
  "page": 1
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | keyword | string | 必填 | 搜索关键词 | | count | int | 10 | 每页条数 | | page | int | 1 | 页码 |

返回字段：帖子ID、标题、摘要（HTML格式）、发布时间、作者信息、浏览数等

注意：

  • description 为 HTML 格式（含 <br/> 等标签），展示前需自行处理
  • target 拼完整 URL：https://xueqiu.com{target}

1.4 searchCubeRanked — 组合排行

用途：搜索组合并按总收益降序排列，支持收益过滤

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "keyword": "实盘",
  "count": 30,
  "minTotalGain": 50,
  "minAnnualRate": 10,
  "topN": 10
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | keyword | string | 必填 | 搜索关键词 | | count | int | 30 | 拉取条数用于排序 | | page | int | 1 | 页码 | | minTotalGain | double | -1 | 最低总收益过滤(%) | | minAnnualRate | double | -1 | 最低年化收益过滤(%) | | topN | int | 10 | 返回前N名 |

二、行情类接口

2.1 getCubeQuote — 组合实时行情

用途：获取组合的实时净值和收益数据

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "symbol": "ZH349701"
}

参数说明： | 参数 | 类型 | 说明 | |---|---|---| | symbol | string | 组合代码，如 ZH349701、SP1008279 |

2.2 getCubeNavHistory — 组合净值历史

用途：获取组合的历史净值数据（日频）

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "cubeId": 349603,
  "count": 30
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | cubeId | int | 必填 | 组合数字ID（从搜索结果的id字段获取） | | count | int | 30 | 返回天数（最大约365） |

三、组合/用户信息接口

3.1 getCubeInfo — 组合详情

用途：获取组合的详细信息，包括持仓、调仓记录等

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "symbol": "ZH012463"
}

参数说明： | 参数 | 类型 | 说明 | |---|---|---| | symbol | string | 组合代码 |

返回字段：组合名称、描述、总收益、年化收益、最新持仓、主人信息等

注意：

  • SP前缀的老组合只返回基础元数据，total_gain/net_value/last_rebalancing 等字段为 null，这是正常行为
  • 部分新组合也可能因数据同步延迟出现字段为 null 的情况，建议调用时做好空值处理

3.2 getUserCubes — 用户创建的所有组合

用途：获取某用户创建的所有组合列表

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "userId": 8601813520
}

参数说明： | 参数 | 类型 | 说明 | |---|---|---| | userId | long | 用户数字ID |

3.3 getUserTimeline — 用户原创发帖

用途：获取用户的原创帖子列表

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "userId": 8601813520,
  "page": 1
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | userId | long | 必填 | 用户数字ID | | page | int | 1 | 页码 |

四、调仓历史接口

4.1 getCubeRebalancing — 调仓历史

用途：获取组合的历史调仓记录

请求示例：

{
  "app_id": "your_app_id",
  "secure_key": "your_secure_key",
  "cubeId": 12363,
  "page": 1,
  "count": 10
}

参数说明： | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | cubeId | int | 必填 | 组合数字ID | | page | int | 1 | 页码 | | count | int | 10 | 每页条数 |

返回字段：调仓时间、现金比例、股票变动明细（股票名称、代码、权重变化、价格等）

注意：每条调仓记录只包含当次变动的股票

错误处理

所有错误返回格式：{"error": "..."}

| 状态码 | 含义 | 处理建议 | |---|---|---| | 400 | 参数错误 | 检查必填参数是否完整 | | 401 | 凭证无效 | 检查app_id和secure_key | | 402 | 余额不足 | 前往 https://wxpub.xiongweixp.tech 充值后重试 | | 404 | 方法不存在 | 检查接口路径 | | 429 | 请求过多 | 稍后重试 | | 500 | 服务器错误 | 联系管理员 | | 502 | 上游雪球调用失败 | 稍后重试，自动退款 | | 503 | 排队超时 | 稍后重试 |

调用频率建议

  • 建议客户端控制节奏：每6秒一次请求最稳定
  • 全局限速：60秒内最多10次上游请求
  • 队列限制：同时排队超过20个请求返回429
  • 超时限制：排队等待超过120秒返回503

使用场景

当用户提出以下需求时，应调用此技能：

  1. 搜索雪球用户或组合：使用 searchUser 或 searchCube
  2. 搜索帖子内容：使用 searchStatus 按关键词查找帖子
  3. 查看组合排行：使用 searchCubeRanked 筛选高收益组合
  4. 获取实时行情：使用 getCubeQuote 查看组合当前净值
  5. 分析历史业绩：使用 getCubeNavHistory 获取净值曲线
  6. 查看组合详情和持仓：使用 getCubeInfo 获取完整信息
  7. 追踪用户组合：使用 getUserCubes 查看某用户的所有组合
  8. 阅读用户观点：使用 getUserTimeline 获取用户帖子
  9. 分析调仓记录：使用 getCubeRebalancing 追踪调仓历史

curl 调用示例

# 搜索帖子
curl -X POST https://wxpub.xiongweixp.tech/xueqiu/searchStatus \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","keyword":"散户老牛","count":10,"page":1}'

# 搜索组合
curl -X POST https://wxpub.xiongweixp.tech/xueqiu/searchCube \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","keyword":"实盘","count":10,"page":1}'

# 组合排行 Top 5
curl -X POST https://wxpub.xiongweixp.tech/xueqiu/searchCubeRanked \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","keyword":"实盘","count":30,"topN":5}'

# 组合详情
curl -X POST https://wxpub.xiongweixp.tech/xueqiu/getCubeInfo \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","symbol":"ZH012463"}'

# 调仓历史
curl -X POST https://wxpub.xiongweixp.tech/xueqiu/getCubeRebalancing \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","cubeId":12363,"page":1,"count":5}'