API

StockGenie API

Public JSON endpoints for daily picks, free history, premium ranked picks, sentiment lookups, and the public signal page.

Base URL: https://api.stockgenie.app Free endpoints available without auth Premium access uses bearer tokens

Quick Start

The simplest call returns the current public pick. If you are subscribed, send your bearer token to access premium endpoints.

# Public daily pick
curl https://api.stockgenie.app/api/daily-stock

# Premium ranked list
curl https://api.stockgenie.app/api/premium-stocks \
  -H "Authorization: Bearer YOUR_TOKEN"

The API returns data only. Daily market alerts are delivered in the app, not through this endpoint.

Free Endpoints

These routes are public and can be used without a subscription. They are rate-limited and cached where possible.

GET
/api/health

Health check with service status, environment, and timestamp.

Free
GET
/api/metadata

App metadata and the next scheduled stock computation.

Free
GET
/api/daily-stock

The public daily pick with confidence, reasons, and source articles.

1 request per day
GET
/api/historical-stocks-free

The free 7-day history view with the public pick for each weekday.

Cached
GET
/api/what-if-invested

Public performance series used by the homepage signal section.

Public

Premium Endpoints

Send a valid bearer token from the app to unlock the full ranked list and deeper analysis.

GET
/api/premium-stocks

The rest of today's ranked picks beyond the public daily selection.

Premium
GET
/api/historical-stocks

Seven days of history with all ranked picks for each trading day.

Premium
GET
/api/stock-sentiment?ticker=AAPL

Sentiment analysis and supporting news for any ticker.

Premium