API Documentation

REST API for US Stock Market, ETFs, options, insider trades, sentiment, and more. Historical data 2000–Present.

Authentication

Include your API key in the x-api-key header for all requests.

x-api-key: YOUR_API_KEY

Stock Endpoints

GET/api/stocks/prices?symbols=AAPL,TSLA,NVDAcache: 60s

Batch stock prices — get real-time prices for up to 50 symbols in a single request. Cached 60s.

Params: symbols (string)*

https://cineprompt-api-production.up.railway.app/api/stocks/prices?symbols=AAPL,TSLA,NVDA

GET/api/stocks/:symbol/pricecache: 60s

Single stock price — current price, change, changePercent, timestamp.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/stocks/AAPL/price

GET/api/stocks/:symbol/history?startDate=2024-01-01&endDate=2024-03-01&interval=1dcache: 60s

Historical OHLCV data — daily, weekly, or monthly bars.

Params: symbol (string)*, startDate (string), endDate (string), interval (string)

https://cineprompt-api-production.up.railway.app/api/stocks/AAPL/history?startDate=2024-01-01&endDate=2024-03-01&interval=1d

GET/api/stocks/:symbol/candles?interval=5m

OHLC candle data — intraday or daily candles.

Params: symbol (string)*, interval (string)

https://cineprompt-api-production.up.railway.app/api/stocks/AAPL/candles?interval=5m

GET/api/stocks/:symbol/profilecache: 60s

Company profile — sector, industry, market cap, exchange.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/stocks/AAPL/profile

GET/api/stocks/:symbol/dividends

Dividend history — ex-date, amount, payment date.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/stocks/AAPL/dividends

GET/api/stocks/:symbol/earnings

Earnings data — report date, EPS, revenue, consensus.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/stocks/AAPL/earnings

Market Endpoints

GET/api/market/statuscache: 60s

US market status — OPEN/CLOSED, next open time, next close time.

https://cineprompt-api-production.up.railway.app/api/market/status

GET/api/market/top-gainerscache: 60s

Top gaining stocks for the day.

https://cineprompt-api-production.up.railway.app/api/market/top-gainers

GET/api/market/top-loserscache: 60s

Top losing stocks for the day.

https://cineprompt-api-production.up.railway.app/api/market/top-losers

GET/api/market/most-activecache: 60s

Most traded stocks by volume.

https://cineprompt-api-production.up.railway.app/api/market/most-active

ETF Endpoints

GET/api/etf/listcache: 60s

Popular ETFs — SPY, QQQ, VTI, DIA, ARKK with current prices.

https://cineprompt-api-production.up.railway.app/api/etf/list

GET/api/etf/:symbolcache: 60s

Single ETF details — symbol, name, price, metadata.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/etf/AAPL

Options Endpoints

GET/api/options/:symbol?expirationDate=2024-03-15&limit=50cache: 60s

Options chain — calls and puts with strike, bid, ask, volume, open interest.

Params: symbol (string)*, expirationDate (string), limit (integer)

https://cineprompt-api-production.up.railway.app/api/options/AAPL?expirationDate=2024-03-15&limit=50

Insider Trades

GET/api/insiders/:symbol?limit=50

Insider trading — name, title, transaction type, shares, price, date.

Params: symbol (string)*, limit (integer)

https://cineprompt-api-production.up.railway.app/api/insiders/AAPL?limit=50

Sentiment

GET/api/sentiment/:symbolcache: 60s

Stock sentiment score (-1 to +1) — BULLISH, NEUTRAL, BEARISH, mentions count.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/sentiment/AAPL

Dark Pool

GET/api/darkpool/:symbol?limit=50

Dark pool trading — price, volume, trade time for off-exchange activity.

Params: symbol (string)*, limit (integer)

https://cineprompt-api-production.up.railway.app/api/darkpool/AAPL?limit=50

Economic Indicators

GET/api/economy/indicatorscache: 5 min

Economic indicators — inflation, interest rate, GDP growth, unemployment.

https://cineprompt-api-production.up.railway.app/api/economy/indicators

Search

GET/api/search?q=apple

Search stocks — symbol and name search.

Params: q (string)*

https://cineprompt-api-production.up.railway.app/api/search?q=apple

Stock Screener

GET/api/screener?sector=Technology&marketCapMin=1000000000&limit=50

Stock screener — filter by sector, market cap, price, volume.

Params: sector (string), marketCapMin (integer), marketCapMax (integer), priceMin (number), priceMax (number), volumeMin (integer), limit (integer)

https://cineprompt-api-production.up.railway.app/api/screener?sector=Technology&marketCapMin=1000000000&limit=50

Technical Indicators

GET/api/indicators/:symbol?rsiPeriod=14&smaPeriod=20

Technical indicators — RSI, SMA, EMA, MACD, Bollinger Bands.

Params: symbol (string)*, rsiPeriod (integer), smaPeriod (integer), emaPeriod (integer), bbPeriod (integer)

https://cineprompt-api-production.up.railway.app/api/indicators/AAPL?rsiPeriod=14&smaPeriod=20

AI Stock Score

GET/api/ai/stock-score/:symbolcache: 60s

AI stock score (0–100) — trend, momentum, volume, volatility.

Params: symbol (string)*

https://cineprompt-api-production.up.railway.app/api/ai/stock-score/AAPL

Developer

GET/api/developer/usage

Usage stats — plan, requests today, remaining, daily limit.

https://cineprompt-api-production.up.railway.app/api/developer/usage

WebSocket (Real-Time)

Real-time stock price streaming. Subscribe to symbols and receive price updates every 5 seconds.

wss://cineprompt-api-production.up.railway.app/ws

Subscribe:

{"action":"subscribe","symbols":["AAPL","TSLA"]}