Documentation Index
Fetch the complete documentation index at: https://tradewatch.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
Stock price data is available at three levels of granularity: real-time quotes for the latest bid/ask, OHLC candles for aggregated historical analysis, and raw ticks for full-resolution historical replay. Use symbol discovery to find available instruments before querying price data.
Endpoints
| Endpoint | Summary | Key use case |
|---|
GET /stocks/quote | Last quote (single) | Display current bid/ask for one symbol |
GET /stocks/quotes | Last quotes (batch) | Dashboard with multiple symbols at once |
GET /stocks/{symbol} | Full stock snapshot | Rich metadata + current price in one call |
GET /stocks/{symbol}/ohlc | Historical OHLC candles | Charts, technical analysis, backtesting |
GET /stocks/{symbol}/ticks | Historical raw ticks | Microstructure research, full-resolution replay |
GET /stocks/symbols | Symbol discovery | Find available instruments |
Last Quotes
Endpoint: GET /stocks/quote · GET /stocks/quotes
The quote endpoints return the most recent bid and ask prices for a symbol. /stocks/quote takes a single symbol query parameter; /stocks/quotes accepts a comma-separated symbols list for fetching multiple instruments in one request.
The precision parameter controls the number of decimal places in the response. Omit it to receive the full native precision.
Key fields
| Field | Type | What it means |
|---|
bid | number | Highest price a buyer is willing to pay |
ask | number | Lowest price a seller is willing to accept |
mid | number | Midpoint between bid and ask |
timestamp | integer | Unix timestamp of the quote |
- Displaying the current price of a stock on a dashboard or ticker
- Checking the latest price before placing a simulated trade
- Fetching prices for a portfolio of holdings in a single request (use
/quotes)
Example
curl "https://api.tradewatch.io/stocks/quote?symbol=AAPL" \
-H "api-key: YOUR_API_KEY"
Historical OHLC
Endpoint: GET /stocks/{symbol}/ohlc
Returns aggregated OHLC (Open, High, Low, Close) candles for a symbol in a selected resolution and time range. Both ask-side and bid-side OHLC values are returned. The resolution parameter specifies the candle width in seconds — for example, 60 for 1-minute candles, 3600 for 1-hour candles, 86400 for daily candles. start and end are Unix timestamps (inclusive and exclusive respectively).
Key fields
| Field | Type | What it means |
|---|
time | integer | Unix timestamp of the candle open |
open_ask / open_bid | number | Opening ask/bid price for the period |
high_ask / high_bid | number | Highest ask/bid reached during the period |
low_ask / low_bid | number | Lowest ask/bid reached during the period |
close_ask / close_bid | number | Closing ask/bid price for the period |
- Rendering price charts (candlestick or OHLC bar charts)
- Backtesting strategies against historical price data
- Computing technical indicators manually from raw OHLC values
Example
# Daily candles for AAPL — adjust start/end Unix timestamps to your desired range
curl "https://api.tradewatch.io/stocks/AAPL/ohlc?resolution=86400&start=1714521600&end=1717113600" \
-H "api-key: YOUR_API_KEY"
Raw Ticks
Endpoint: GET /stocks/{symbol}/ticks
Returns every individual price tick for a symbol within a time range, using cursor pagination. Each tick contains the bid, ask, and mid price at a specific moment. Unlike OHLC, ticks are not aggregated — you receive every recorded price change.
Key fields
| Field | Type | What it means |
|---|
time | string | ISO 8601 timestamp of the tick |
ask | number | Ask price at this moment |
bid | number | Bid price at this moment |
mid | number | Midpoint at this moment |
- High-resolution backtesting where candle granularity is insufficient
- Microstructure research (spread analysis, intraday volatility)
- Building a local tick database for a specific symbol and period
Use OHLC instead of ticks when you only need aggregated price action — ticks produce much larger datasets for the same time range.
Example
curl "https://api.tradewatch.io/stocks/AAPL/ticks?start=1717027200&end=1717113600&limit=100" \
-H "api-key: YOUR_API_KEY"
Symbol Discovery
Endpoint: GET /stocks/symbols
Returns a paginated list of available stock symbols. Use the country parameter to filter by market, type to filter by instrument type, and cursor to page through results.
When to use
- Building a symbol search or autocomplete feature
- Discovering which symbols are available for a specific market before requesting price data
Example
# List US stocks, 50 per page
curl "https://api.tradewatch.io/stocks/symbols?country=US&size=50" \
-H "api-key: YOUR_API_KEY"
