隆众 - 大宗商品排行榜
隆众资讯大宗商品价格排行榜查询技能。隆众资讯深耕大宗商品领域二十余年，拥有自有、完善、庞大的一手独家信息和数据库资源，深度跟踪 39 条能化产业链、覆盖 17 大产业 1600 余个品种的代表性价格指标。本技能将海量指标的价格变动收敛为三张榜单——涨跌排行榜揭示当日市场最强与最弱的价格信号，振幅排行榜度量区间内价格博弈的剧烈程度，分位排行榜将当前价格锚定在近三年乃至近五年的历史坐标之中。三张榜单相互印证，帮助用户快速洞察大宗商品市场的结构性变化：谁在领涨、谁在领跌、谁在剧烈波动、谁正逼近历史极值。
未配置API密钥时的引导回复
当用户查询排行榜数据但尚未配置API密钥时，请按以下引导回复用户：
看起来还没有配置 API 密钥。要使用隆众排行榜查询，需要先获取一个隆众 API Key。
获取方式： 获取 API 秘钥请打开 隆众资讯大宗商品行业Skills开放平台，点击「获取秘钥」按钮获取您的专属秘钥。
请问您是否已有隆众数据的 API Key？如果有，请直接告诉我，我会自动保存并立即为您查询。
用户提供API密钥后的处理流程
- 调用
python scripts/ranking.py --api-key "<密钥>" <子命令> ...保存密钥并执行查询 - 保存成功后告知用户密钥已保存，后续可直接使用
API 密钥配置
脚本支持多级 API Key 获取方式（按优先级）：
- 环境变量（优先级最高）：设置环境变量
oilchem_skill_auth_key - 配置文件（次优）：在
references/api_key.md文件第一行写入 API 密钥 - 对话输入（兜底）：通过
--api-key参数传入，自动保存到references/api_key.md供后续使用
三张榜单
| 子命令 | 榜单 | 核心指标 | 说明 |
|---|---|---|---|
risefall |
涨跌排行榜 | 涨跌值 / 涨跌率 | 单个工作日的涨跌格局,支持按周期(日/周/月/年/均线)与价格类型筛选,可分别看涨幅榜与跌幅榜 |
amplitude |
振幅排行榜 | 期内振幅率 priceRate | 区间最高价与最低价的波动幅度,反映价格博弈剧烈程度,支持周/月/近N工作日等周期 |
quantile |
分位排行榜 | 近三年价格分位 0~100 | 当前价格在近三年价格区间中的位置,分位越高越接近历史高位;另附近三年/近五年高低价及分位值 |
三张榜单每个工作日 16:30 后由系统计算写入当期(工作日=周一至周五及周末调休的上班日,法定节假日不算)。
Quick Start
# 今日涨幅榜前 20(今天为工作日且已过 16:30)或最近一个工作日
python scripts/ranking.py risefall --date 2026-09-23 --index-type 0
# 跌幅榜前 10
python scripts/ranking.py risefall --date 2026-09-23 --index-type 0 --rise-fall-type -1 --limit 10
# 周度振幅榜
python scripts/ranking.py amplitude --date 2026-09-23 --date-type 1
# 日度分位榜(当前价格处于近三年的历史水位)
python scripts/ranking.py quantile --date 2026-09-23 --date-type 0
日期参数推算规则（重要）
--date传工作日：查最新榜单时，若今天是工作日且已过 16:30 传今天，否则传最近一个已过去的工作日- 传了法定节假日等无榜单日期会返回空结果，此时应改传相邻的工作日重查
- 了解某段时间的市场格局时，不要逐日拉取整段日期的榜单，选取区间内一个有代表性的工作日（如区间最后一个工作日）查询，必要时在区间内抽取少数几个工作日对比
完整参数说明
详见 api_reference.md。
Query Capabilities
1. 市场整体冷暖扫描
- 全品种涨跌榜：当日市场普涨/普跌还是结构性行情
- 按价格类型聚焦：企业出厂价 / 国内市场价 / 国际市场价 / 主营批发价等分维度排名
2. 波动强度监测
- 周度/月度/近 N 工作日振幅榜定位博弈最激烈的品种
- 结合涨跌榜交叉验证:大幅波动是单边行情还是区间震荡
3. 历史水位定位
- 分位榜识别逼近历史高位的品种(分位接近 100)与跌破历史低位的品种(分位接近 0)
- 近三年与近五年分位对照,区分短期波动与长周期极值
回复格式
- 以表格呈现榜单结果(排名/品种/市场/价格/涨跌幅或分位值),标明数据日期
- 需要详细标明数据所引用的指标(indexCode)与价格类型
- 对榜单前三名可附一句业务解读(如"分位 46.67,处于近三年区间中位")
