市场事件

查询金融建模准备（FMP）API，报告观察列表中股票代码的即将发生或近期收益、股息和股票拆分事件。

快速开始

bash

查询特定股票代码的事件（未来7天）

python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --tickers AAPL,MSFT,GOOG

使用股票代码文件

python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --file tickers.txt

组合使用，自定义时间范围，特定事件类型

python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --tickers NVDA --file watchlist.csv --range 14d --types earnings,dividends

查询过去股息（最近30天）

python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --tickers AAPL --range -30d --types dividends

使用方法

python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py [选项]

选项：
--tickers 股票代码 逗号分隔的股票代码列表
--file 路径 股票代码的.txt或.csv文件路径
--range 时间范围 前瞻/回顾窗口。单位：d/w/y。负值表示回顾。
示例：7d, 2w, -30d, -1y。默认：7d。最大：365d/52w/1y。
--format 格式 输出格式：text、json或discord。默认：text。
--types 类型 逗号分隔的事件类型：earnings,dividends,splits。默认：全部。
-h, --help 显示帮助信息

必须提供--tickers或--file中的至少一个。

股票代码文件格式

纯文本（.txt）

AAPL
MSFT

这是注释

GOOG

CSV（.csv）

第一列用作股票代码。表头行会被自动检测并跳过。

ticker,name
AAPL,Apple Inc
MSFT,Microsoft Corp

输出格式

文本（默认）

市场事件：2026-03-16 → 2026-03-23（3个股票代码，收益/股息/拆分）
──────────────────────────────────────────────────────────────────────
日期 股票代码 类型 详情
2026-03-18 AAPL 收益 每股收益预估：1.52 营收预估：94.36B
2026-03-20 MSFT 股息 股息：0.75 除息日：2026-03-20 支付日：2026-04-10
──────────────────────────────────────────────────────────────────────
找到2个事件。

JSON（--format json）

json
{
range: {from: 2026-03-16, to: 2026-03-23},
ticker_count: 3,
types: [earnings, dividends, splits],
event_count: 2,
events: [
{date: 2026-03-18, ticker: AAPL, event_type: earnings, detail: 每股收益预估：1.52 营收预估：94.36B, raw: { ... }},
{date: 2026-03-20, ticker: MSFT, event_type: dividends, detail: 股息：0.75 除息日：2026-03-20, raw: { ... }}
]
}

raw字段包含每个事件的完整FMP API响应。

Discord（--format discord）

市场事件 2026-03-16 → 2026-03-23（3个股票代码，收益/股息/拆分）
💰 AAPL 2026-03-18 — 每股收益预估：1.52 营收预估：94.36B
💵 MSFT 2026-03-20 — 股息：0.75 除息日：2026-03-20 支付日：2026-04-10
找到2个事件。

注意事项

• - 需要requests库（pip install requests）。
• FMP免费版有速率限制。该技能会处理429响应并发出警告，继续返回部分结果。
• 事件按日期升序排列，然后按事件类型（收益 → 股息 → 拆分）排序。