market-data

市场数据 API

通过 eng0 的数据代理服务访问美国股票市场数据。

基础 URL

https://api.eng0.ai/api/data

数据覆盖范围

• 所有美国股票代码
• 5 年历史数据
• 100% 市场覆盖
• 延迟 15 分钟的报价

---

可用端点

端点	用途
POST /stocks/bars	OHLCV 价格柱（间隔为 1min 至 1week）
POST /stocks/news	带情绪分析的新闻文章
POST /stocks/details	公司信息和市值
GET /schema	API 架构发现

---

获取价格柱

获取股票的 OHLCV（开盘价、最高价、最低价、收盘价、成交量）价格柱。

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）

响应：

{
  "ticker": "AAPL",
  "count": 21,
  "bars": [
    {
      "t": "2024-12-02T05:00:00.000Z",
      "o": 237.27,
      "h": 240.79,
      "l": 237.16,
      "c": 239.59,
      "v": 48137103,
      "vw": 239.4992,
      "n": 469685
    }
  ]
}

响应字段：

字段	描述
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）

响应：

{
  "count": 5,
  "articles": [
    {
      "title": "Tesla Stock Rises on Strong Delivery Numbers",
      "description": "Tesla reported better-than-expected Q4 deliveries...",
      "author": "John Smith",
      "publisher": "Reuters",
      "publishedAt": "2025-01-06T14:30:00Z",
      "url": "https://...",
      "tickers": ["TSLA"],
      "keywords": ["electric vehicles", "deliveries"],
      "sentiment": "positive",
      "sentimentReasoning": "Article discusses strong delivery numbers and positive market reaction."
    }
  ]
}

情绪值： positive、negative、neutral

---

获取公司详情

获取股票代码对应的公司信息。

curl -X POST https://api.eng0.ai/api/data/stocks/details \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AAPL"}'

参数：

名称	类型	必填	描述
ticker	string	是	股票代码

响应：

{
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "description": "Apple Inc. designs, manufactures, and markets smartphones...",
  "market": "stocks",
  "primaryExchange": "XNAS",
  "type": "CS",
  "currencyName": "usd",
  "marketCap": 3949128102780,
  "listDate": "1980-12-12",
  "sicDescription": "ELECTRONIC COMPUTERS",
  "homepage": "https://www.apple.com",
  "totalEmployees": 164000
}

---

常见工作流

获取最近 30 天的每日价格

curl -X POST https://api.eng0.ai/api/data/stocks/bars \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "NVDA",
    "interval": "1day",
    "from": "2024-12-07",
    "to": "2025-01-07"
  }'

获取日内数据（1 分钟价格柱）

curl -X POST https://api.eng0.ai/api/data/stocks/bars \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "AAPL",
    "interval": "1min",
    "from": "2025-01-06",
    "to": "2025-01-06"
  }'

获取 1 年的每周价格柱

curl -X POST https://api.eng0.ai/api/data/stocks/bars \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "MSFT",
    "interval": "1week",
    "from": "2024-01-01",
    "to": "2025-01-01"
  }'

获取近期新闻及情绪分析

curl -X POST https://api.eng0.ai/api/data/stocks/news \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "GOOGL",
    "limit": 20
  }'

---

与 Python 搭配使用

import requests

BASE_URL = "https://api.eng0.ai/api/data"

def get_price_bars(ticker: str, interval: str, from_date: str, to_date: str):
    """Get OHLCV price bars for a stock."""
    response = requests.post(
        f"{BASE_URL}/stocks/bars",
        json={
            "ticker": ticker,
            "interval": interval,
            "from": from_date,
            "to": to_date
        }
    )
    return response.json()

def get_news(ticker: str, limit: int = 10):
    """Get news articles with sentiment for a stock."""
    response = requests.post(
        f"{BASE_URL}/stocks/news",
        json={"ticker": ticker, "limit": limit}
    )
    return response.json()

def get_company_details(ticker: str):
    """Get company information."""
    response = requests.post(
        f"{BASE_URL}/stocks/details",
        json={"ticker": ticker}
    )
    return response.json()

# Examples
bars = get_price_bars("AAPL", "1day", "2024-12-01", "2024-12-31")
print(f"Got {bars['count']} bars for {bars['ticker']}")

news = get_news("TSLA", limit=5)
for article in news['articles']:
    print(f"[{article['sentiment']}] {article['title']}")

details = get_company_details("NVDA")
print(f"{details['name']}: Market Cap ${details['marketCap']:,}")

---

错误处理

无效参数：

{
  "error": "Invalid parameters",
  "message": "Missing required parameter: ticker"
}

未知操作：

{
  "error": "Unknown operation",
  "message": "Operation 'invalid' not found. Available: bars, news, details"
}

---

重要说明

• 股票代码必须为大写（例如：AAPL，而非 aapl）
• 所有时间戳均为 UTC（ISO 8601 格式）
• 价格数据延迟 15 分钟
• 提供 5 年历史数据
• 无速率限制（请合理使用）

---

与其他技能组合使用

此技能提供市场数据。可与以下技能组合使用：

• sec-edgar-skill（EdgarTools）→ SEC 文件、财务报表
• financial-deep-research → 完整研究工作流和报告

组合工作流示例：

1. 获取公司详情和近期价格柱（此技能）
2. 获取 SEC 文件和财务报表（sec-edgar-skill）
3. 生成全面的研究报告（financial-deep-research）