# US Stocks

> Skill `us-stocks` on Faro. 2 sub-skills.

Get historical US equity price data (open, high, low, close, volume) for any publicly listed US stock, at daily or hourly resolution, over any date range. Use it to chart price history, compute returns, backtest strategies, or pull raw numbers for analysis, with no made-up data. A free cost-preview operation lets you size a query before committing.

**Category:** Finance & Markets  
**Tags:** stocks, equities, market-data, ohlcv, prices  
**Use when:** You need actual past US stock prices over a date range instead of made-up numbers, for one or many tickers.  
**Not for:** Live or latest quotes, sub-hourly or trade-level data, fundamentals, earnings, dividends, splits, news, analyst ratings, options, futures, crypto, forex, or non-US listings.  
**Returns:** information — Returns price bars carrying the symbol, the bar opening time in UTC, and open, high, low, close, and volume. Trading-day gaps for weekends and holidays are normal. The cost preview returns an indicative credit cost for a pull. Not a downloadable file.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/us-stocks/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What was Apple's stock price last week?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run us-stocks "What was Apple's stock price last week?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What was Apple's stock price last week?
- How much would it cost to pull a year of daily data for 10 tickers?

## Sub-skills

### Price history

Returns historical daily or hourly OHLCV bars for one or more US tickers over a date range.

**Cost:** ~2 credits / query (up to 10000) — A short range for a few tickers is the usual case; wide date ranges, many tickers, or hourly bars return far more data and cost more.

**Use when:** You want actual past open, high, low, close, and volume for US stocks to chart, analyze, or compute returns.

**Details:** https://askfaro.com/llms/skills/us-stocks/prices.md

---

### Cost preview

Previews the cost of a price pull for the same query, for free, before any data is fetched.

**Cost:** Free

**Use when:** You want to know what a date range and ticker set will cost before pulling the price history.

**Details:** https://askfaro.com/llms/skills/us-stocks/estimate_cost.md

---

---
On the web: https://askfaro.com/search/us-stocks