核心用法
SentiSense 是一个只读金融情报 API，为 AI 代理和量化研究者提供聚合的市场数据层。核心能力覆盖六大维度：实时股价与历史图表、多源情绪指标（新闻/社交/Reddit/X）、SEC 内幕交易（Form 4）、机构 13F 持仓流向、国会政治人物交易披露（STOCK Act），以及 AI 生成的综合信号。API 采用 REST 设计，认证仅需 X-SentiSense-API-Key 头部，返回标准 JSON。
典型工作流：
1. 调用 /stocks/market-status 确认市场状态
2. 获取 /institutional/quarters 最新季度日期（切勿硬编码）
3. 并发查询 /stocks/price、情绪时间序列、内幕/机构/政治人物活动
4. 使用 AI 洞察端点（/insights/stock/{ticker}）获得融合多源的优先级信号
关键端点模式：
- 所有 PRO-gated 端点返回
{isPreview, previewReason, data}包装器，需解包data字段 - 免费 tier 对列表类端点返回截断数据（如机构流向前 5、内幕交易前 5），但价格、图表、基础情绪指标完全开放
- 发现类端点（如
/stocks/with-kpis）不计入月度配额
显著优点
1. 多源异构数据融合：单一 API 整合传统市场数据（价格、基本面）与替代数据（社交情绪、政治人物交易、机构 13F），降低多供应商集成成本
2. AI 原生设计：提供预计算的 AI 摘要（ai-summary）、综合洞察（insights）和异常检测（情绪基线偏离），适合 LLM 代理直接消费
3. 清晰的权限与成本控制：免费 tier（1,000 次/月，30/min）到 PRO（$15/月，无限制，300/min）的阶梯明确，且通过 isPreview 标志让开发者清晰感知数据完整度
4. 政治人物交易特色：STOCK Act 数据在同类 API 中相对少见，支持按议员、党派、州筛选，适合"聪明钱"追踪策略
5. 无状态只读安全模型：明确禁止交易、购买、钱包操作，从架构上消除资金风险
潜在缺点与局限性
1. 免费 tier severely 受限：关键功能如完整机构持仓、AI 深度报告（depth=deep 限 10 次/月）、完整内幕交易列表均需 PRO，免费层仅适合原型验证
2. 数据延迟与覆盖缺口：机构 13F 数据按季度披露（滞后 45 天），内幕交易每日更新但非实时，政治人物披露延迟可达 30-45 天，不适合高频策略
3. 替代数据未经验证：社交情绪、AI 洞察的预测有效性未在文档中提供回测证据，"聪明钱"信号可能产生假阳性
4. ETF 覆盖有限：Beta 阶段仅覆盖主要 ETF（SPY、QQQ、VOO 等），持仓加权聚合可能因部分覆盖产生偏差
5. 无历史逐笔数据：仅提供日级 OHLCV，无 Level 2 或逐笔成交，限制微观结构分析
适合人群
- 量化研究员与个人投资者：构建多因子模型，追踪机构调仓与政治人物交易信号
- AI 金融代理开发者：需要结构化、预聚合的数据源供 LLM 做推理与报告生成
- 财经内容创作者：快速生成 AI 摘要、情绪热图、聪明钱追踪图表
- 合规敏感场景：只读架构适合企业内部分析，避免交易执行带来的合规审查
常规风险
1. 非投资建议声明：文档多次强调数据仅供参考，AI 洞察与情绪指标可能产生错误信号，用户需独立判断
2. API 密钥泄露风险：密钥泄露可能导致配额被刷或 PRO 订阅滥用，需妥善保管
3. 数据源可靠性：社交情绪依赖第三方抓取（Reddit、X），存在平台 API 变更或封禁导致数据中断的风险
4. 回测过拟合风险：政治人物交易、机构 13F 等滞后数据用于历史回测时，需警惕前视偏差（look-ahead bias）