Data API 预览

Alphio Agent API v1 预览 —— 只读数据端点，schema 稳定。

入口：尚未公开发布。下文端点描述早期试用阶段的 v1 接口面。

注意

下面的 v1 端点仅为预览 —— 在公开发布前，确切 URL 与字段形状仍可能调整。请把它们当作形状指引而非契约。

---

1. 搜索端点

搜索接口面返回热门 / Trending 的股票和加密 symbol，以及精选 feature 列表。

• GET /v1/search/default —— 默认发现 payload：热门股票、热门加密、feature 区块、Trending news。客户端首次加载、用户尚未输入时使用。
• GET /v1/search/symbol?q=<query> —— 在支持的宇宙内（美股 / 港股、ETF、加密、FX、贵金属）做名称 / ticker 搜索。

搜索端点是只读的；预览期可以在不认证的情况下调用，但限流仍按 key / 钱包独立计算。

---

2. 市场资讯

• GET /v1/news/market-news —— 全市场资讯流，分页，带时间戳与来源。
• GET /v1/news/symbol-news?symbol=<ticker> —— 单 ticker 资讯。

资讯条目尽量带 Alphio AI 的总结字段，客户端不必再二次总结。

---

3. AI top picks

• GET /v1/finance/daily-top-pick/stocks —— Alphio AI 精选的每日股票 top-pick。
• GET /v1/finance/daily-top-pick/crypto —— 每日加密 top-pick。

每条返回 symbol、信心等级以及一段简短理由。

---

4. Symbol 基本面

基本面拆成 3 个逻辑接口：

• 快照（Snapshot） —— GET /v1/finance/symbol/:symbol/snapshot —— 价格概览、关键比率、头部指标。
• 估值（Valuation） —— GET /v1/finance/symbol/:symbol/valuation —— 倍数、对标公司、估值信号。
• 财务（Financials） —— GET /v1/finance/symbol/:symbol/financials —— 利润表、资产负债表、现金流量表。

快照按日内更新；估值与财务按披露节奏更新。

---

5. 财报与预测

• GET /v1/finance/earnings/calendar —— 即将发布的财报，含日期、时段、Consensus。
• GET /v1/finance/earnings/predictions?symbol=<ticker> —— Alphio AI 财前预测（与 Consensus 的差值、情景判断）。
• GET /v1/finance/earnings/transcripts?symbol=<ticker> —— 财报电话会议纪要，尽量带 speaker 标记。

已披露的财报附 Alphio AI 财后分析（如有）。

---

6. 日历与事件

• GET /v1/finance/calendar/economic —— 宏观 / 经济数据发布。
• GET /v1/finance/calendar/ipo —— 即将上市的 IPO。
• GET /v1/finance/calendar/crypto —— 重要加密事件（代币解锁、主网上线）。
• GET /v1/finance/calendar/webcast —— 投资者日 / Webcast 日程。

所有日历端点支持日期范围过滤；适用的端点支持区域 / 市场过滤。

---

7. 市场指标

• GET /v1/finance/indicators/fear-greed —— 恐贪指数时间序列。
• GET /v1/finance/indicators/sentiment —— 更广义的情绪聚合（资讯、社交）。
• GET /v1/finance/indicators/digest —— 每日 / 每周 digest 内容（Market Brief 背后的数据源）。

指标端点同时返回当前值与近期历史，方便绘图。

---

8. 巨鲸追踪

• GET /v1/finance/whales/institutional?symbol=<ticker> —— 13F 机构持仓与最近变更。
• GET /v1/finance/whales/congress?symbol=<ticker> —— 美国国会披露交易。

加密侧的钱包级追踪将在后续预览中以独立的 /wallets 端点提供。

---

9. 请求示例

最简请求使用 Authentication 中描述的 API Key Bearer 头：

curl https://api.alphio.example/v1/finance/daily-top-pick/stocks \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Accept: application/json"

x402（按量付费）下，同一调用将 Bearer 头替换为 x402 支付头 —— 头部由你的 x402 客户端库构造；协议简介见 Authentication。

注意

示例中的 api.alphio.example 仅为占位主机名。实际 API 主机与精确路径前缀会随早期试用邀请公布 —— 不要把示例主机写死进生产客户端。