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, notaapl) - 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:
- Get company details and recent price bars (this skill)
- Get SEC filings and financial statements (sec-edgar-skill)
- Generate comprehensive research report (financial-deep-research)