---

name: market-data description: Access US stock market data including price bars, news with sentiment, and company details via eng0 data API. Use when user asks for stock prices, OHLCV data, price history, stock news, or company information. Triggers include "stock price", "price history", "OHLCV", "stock news", "company info", "market data", "ticker data". Do NOT use for SEC filings (use sec-edgar-skill instead).

Market Data API

Access US stock market data through eng0's data proxy service.

Base URL

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

Data Coverage

• All US stock tickers
• 5 years of historical data
• 100% market coverage
• 15-minute delayed quotes

---

Available Endpoints

| Endpoint | Purpose | |----------|---------| | POST /stocks/bars | OHLCV price bars (1min to 1week intervals) | | POST /stocks/news | News articles with sentiment analysis | | POST /stocks/details | Company information and market cap | | GET /schema | API schema discovery |

---

Get Price Bars

Retrieve OHLCV (Open, High, Low, Close, Volume) bars for a stock.

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"
  }'

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | ticker | string | Yes | Stock symbol (e.g., AAPL, MSFT) | | interval | string | Yes | 1min, 5min, 15min, 30min, 1hour, 4hour, 1day, 1week | | from | date | Yes | Start date (YYYY-MM-DD) | | to | date | Yes | End date (YYYY-MM-DD) |

Response:

{
  "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
    }
  ]
}

Response Fields:

| Field | Description | |-------|-------------| | t | Timestamp (ISO 8601 UTC) | | o | Open price | | h | High price | | l | Low price | | c | Close price | | v | Volume | | vw | Volume-weighted average price | | n | Number of transactions |

---

Get News

Retrieve financial news articles with sentiment analysis.

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

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | ticker | string | Yes | Stock symbol | | limit | number | No | Max articles (default: 10, max: 100) |

Response:

{
  "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."
    }
  ]
}

Sentiment Values: positive, negative, neutral

---

Get Company Details

Retrieve company information for a stock ticker.

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

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | ticker | string | Yes | Stock symbol |

Response:

{
  "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
}

---

Common Workflows

Get Last 30 Days of Daily Prices

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"
  }'

Get Intraday Data (1-minute bars)

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"
  }'

Get Weekly Bars for 1 Year

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"
  }'

Get Recent News with Sentiment

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

---

Using with 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 Handling

Invalid Parameters:

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

Unknown Operation:

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

---

Important Notes

• Tickers must be UPPERCASE (e.g., AAPL, not aapl)
• All timestamps are UTC (ISO 8601 format)
• Price data is 15-minute delayed
• Historical data available for 5 years
• No rate limits (use responsibly)

---

Combining with Other Skills

This skill provides market data. Combine with:

• sec-edgar-skill (EdgarTools) → SEC filings, financial statements
• financial-deep-research → Full research workflow and reports

Example combined workflow:

1. Get company details and recent price bars (this skill)
2. Get SEC filings and financial statements (sec-edgar-skill)
3. Generate comprehensive research report (financial-deep-research)