雪球数据接口技能

概述

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

接口基础信息

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

公共请求字段

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

凭证设置提醒

如果用户未设置 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
}

参数说明：

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

1.2 searchCube — 搜索组合

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

请求示例：

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

参数说明：

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

1.3 searchCubeRanked — 组合排行

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

请求示例：

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

参数说明：

二、行情类接口

2.1 getCubeQuote — 组合实时行情

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

请求示例：

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

参数说明：

2.2 getCubeNavHistory — 组合净值历史

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

请求示例：

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

参数说明：

三、组合/用户信息接口

3.1 getCubeInfo — 组合详情

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

请求示例：

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

参数说明：

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

注意：

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

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

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

请求示例：

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

参数说明：

3.3 getUserTimeline — 用户原创发帖

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

请求示例：

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

参数说明：

四、调仓历史接口

4.1 getCubeRebalancing — 调仓历史

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

请求示例：

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

参数说明：

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

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

错误处理

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

调用频率建议

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

使用场景

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

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

curl 调用示例

# 搜索组合
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}'