Faro
Tools/us-stocks
US Stocks

US Stocks

Active

Your agent invents stock prices; this returns real daily and hourly OHLCV bars.

2 tools

US equity price history: daily or hourly OHLCV bars for one or more tickers across a date range, drawn from a consolidated US equities feed. Includes a free cost estimate before you pull data.

Finance & Marketsstocksequitiesmarket-dataohlcvprices

Tools (2)

Default

▶prices

Historical OHLCV price bars for one or more US tickers over a date range.

Usage-based · Priced by how much data the query returns, from 1 credit; run estimate_cost to see the exact cost before you pull

Example prompts

  • “Get Apple's daily closing prices for January 2024”
  • “Pull hourly bars for MSFT and NVDA last week”
  • “Historical daily OHLCV for TSLA this year”
  • “Show hourly bars for AAPL on 2024-03-01”

Parameters

endstringoptional

Optional range end (exclusive), ISO 8601 date or datetime.

limitintegeroptionaldefault: 1000

Maximum number of bars to return (total across all symbols). Larger pulls cost proportionally more.

startstringrequired

Range start, ISO 8601 date or datetime (e.g. 2024-01-01). Assumed UTC.

schemastringoptionaldefault: "ohlcv-1d"

Bar size: ohlcv-1d (daily) or ohlcv-1h (hourly).

datasetstringoptionaldefault: "EQUS.MINI"

US equities dataset. EQUS.MINI (consolidated intraday) or EQUS.SUMMARY (daily summary).

symbolsstringrequired

Comma-separated US tickers (e.g. "AAPL,MSFT,NVDA").

encodingstringoptionaldefault: "json"

Output encoding. Fixed to JSON.

stype_instringoptionaldefault: "raw_symbol"

Symbology of the input symbols. Defaults to raw_symbol (plain tickers).

pretty_pxstringoptionaldefault: "true"

Return human-scaled decimal prices.

pretty_tsstringoptionaldefault: "true"

Return ISO 8601 timestamps.

map_symbolsstringoptionaldefault: "true"

Include the ticker symbol on each returned bar.

API Usage

curl -X POST "https://skill.askfaro.com/skills/us-stocks/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get Apple's daily closing prices for January 2024"
  }
}'

CLI Usage

askfaro describe us-stocks/prices

Install pip install askfaro-cli, then askfaro auth login.

Metadata

▶estimate_cost

Preview the upstream data cost of a price query before pulling it.

Free

Example prompts

  • “How much would daily AAPL prices for 2023 cost to pull?”
  • “Estimate the cost of hourly bars for MSFT this month”
  • “Preview the data cost for this query”

Parameters

endstringoptional

Optional range end (exclusive), ISO 8601 date or datetime.

startstringrequired

Range start, ISO 8601 date or datetime.

schemastringoptionaldefault: "ohlcv-1d"

Bar size to price.

datasetstringoptionaldefault: "EQUS.MINI"

US equities dataset.

symbolsstringrequired

Comma-separated US tickers (e.g. "AAPL,MSFT").

API Usage

curl -X POST "https://skill.askfaro.com/skills/us-stocks/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "How much would daily AAPL prices for 2023 cost to pull?"
  }
}'

CLI Usage

askfaro describe us-stocks/estimate_cost

Install pip install askfaro-cli, then askfaro auth login.

▶README

US Stocks

Historical price bars (open, high, low, close, volume) for US-listed equities, from a consolidated US equities feed.

Workflow

  1. (Optional) Call estimate_cost with the same parameters to preview the data cost before pulling.
  2. Call prices with one or more symbols, a schema (daily or hourly bars), and a start (and optional end) date. Results come back as JSON with human-readable prices and timestamps.

Scope

  • Coverage is US equities only (consolidated feed). Non-US equities are not available in this wave.
  • Bars are OHLCV at daily and hourly resolution. Keep the symbol set and date range modest; the limit caps how many bars return.

Pricing

prices is billed by the volume of data the query returns: a small pull is a fraction of a credit, a large one scales up. Call estimate_cost first to preview a query's cost, and use limit plus a tight date range and symbol set to keep pulls small.