Market Data 是一个用于访问美国股票市场数据的技能，通过 eng0 的数据代理服务提供数据。
用途 该技能用于在用户需要股票价格、OHLCV 数据、带情感分析的新闻或公司详情时获取美股市场数据。
数据覆盖
- 覆盖全部美股代码
- 提供 5 年历史数据
- 100% 市场覆盖
- 报价延迟 15 分钟
可用端点
- POST /stocks/bars：OHLCV 价格 K 线（1 分钟到 1 周间隔）
- POST /stocks/news：带情感分析的新闻文章
- POST /stocks/details：公司信息与市值
- GET /schema：API 结构发现
基础地址 https://api.eng0.ai/api/data
获取价格 K 线 检索某只股票的 OHLCV（开盘、最高、最低、收盘、成交量）K 线。
curl -X POST https://api.eng0.ai/api/data/stocks/bars
-H "Content-Type: application/json"
-d '{
"ticker": "AAPL",
"interval": "1day",
"from": "2024-12-01",
"to": "2024-12-31"
}'
参数：
- ticker（string，必填）：股票代码（如 AAPL、MSFT）
- interval（string，必填）：1min、5min、15min、30min、1hour、4hour、1day、1week
- from（date，必填）：开始日期（YYYY-MM-DD）
- to（date，必填）：结束日期（YYYY-MM-DD）
响应字段：
- t：时间戳（ISO 8601 UTC）
- o：开盘价
- h：最高价
- l：最低价
- c：收盘价
- v：成交量
- vw：成交量加权平均价
- n：交易笔数
获取新闻 检索带情感分析的财经新闻文章。
curl -X POST https://api.eng0.ai/api/data/stocks/news
-H "Content-Type: application/json"
-d '{
"ticker": "TSLA",
"limit": 5
}'
参数：
- ticker（string，必填）：股票代码
- limit（number，可选）：最大文章数（默认 10，最大 100）
响应包含标题、描述、作者、发布方、发布时间、URL、相关代码、关键词、情感（positive、negative、neutral）及情感理由。
获取公司详情 检索某只股票代码对应的公司信息。
curl -X POST https://api.eng0.ai/api/data/stocks/details
-H "Content-Type: application/json"
-d '{"ticker": "AAPL"}'
参数：
- ticker（string，必填）：股票代码
响应包含名称、描述、市场、主要交易所、类型、货币名称、市值、上市日期、SIC 描述、主页、员工总数等。
常见工作流
- 获取最近 30 天日线价格
- 获取日内数据（1 分钟 K 线）
- 获取 1 年周线 K 线
- 获取带情感的近期新闻
使用 Python 可通过 requests 库调用上述端点，示例代码见官方文档。
错误处理
- 无效参数：返回 error 与 message，如缺少必填参数 ticker
- 未知操作：返回 error 与 message，提示可用操作为 bars、news、details
重要说明
- 股票代码必须大写（如 AAPL，而非 aapl）
- 所有时间戳为 UTC（ISO 8601 格式）
- 价格数据延迟 15 分钟
- 历史数据可获取 5 年
- 无速率限制（请合理使用）
与其他技能组合 该技能提供市场数据，可与以下技能组合：
- sec-edgar-skill（EdgarTools）→ SEC 文件、财务报表
- financial-deep-research → 完整研究工作流与报告
组合工作流示例：
- 获取公司详情与近期价格 K 线（本技能）
- 获取 SEC 文件与财务报表（sec-edgar-skill）
- 生成综合研究报告（financial-deep-research）