API Reference

Read-only access to AI-curated stock research: sentiment, news articles, daily digests, fundamentals, insider activity, flagged risks, macro time-series, and published earnings. Plus a write endpoint for pushing trade setups (NovaTrade integration).

v1.0.0 openapi.jsonBase URL: https://www.thickerpeek.com

Authentication

Every request requires a personal-access token in the Authorization header. Tokens are bound to scopes (e.g. read:sentiment) and to the granted user's plan tier.

curl -H "Authorization: Bearer ti_<your-token>" \
  https://www.thickerpeek.com/api/external/sentiment?symbol=ASML

Manage tokens

Research

GET/api/external/sentimentread:sentiment

Daily sentiment for a symbol

Returns today's regex-classified headline sentiment for a stock, plus a 7-day trailing average. Sentiment is bullish/neutral/bearish; confidence is 0–1.

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker, e.g. ASML or AAPL

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/sentiment?symbol=ASML"

Response

200 OK with the latest classified sentiment.

{
  "symbol": "ASML",
  "sentiment": "bullish",
  "confidence": 0.74,
  "asOf": "2026-05-07"
}

GET/api/external/articlesread:articles

Recent news articles for a symbol

Fetches news articles tagged to a symbol within a lookback window. Each article includes materiality (low/medium/high), source, and headline.

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker
sinceDays	number	optionaldefault 7	Lookback window
limit	number	optionaldefault 100	Max articles
minMateriality	string (low\|medium\|high)	optional	Floor on materiality

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/articles?symbol=ASML&sinceDays=7&limit=100"

Response

200 OK with article list, ordered most-recent first.

{
  "symbol": "ASML",
  "articles": [
    {
      "date": "2026-05-07",
      "title": "ASML wins TSMC follow-on order for 18A node",
      "source": "reuters",
      "materiality": "high"
    }
  ]
}

GET/api/external/digestread:digest

Daily AI digest

Returns the AI-written daily digest for a symbol — Dutch summary text, top events, sentiment (today + 7d), direction call, flagged risks, and earnings flag. Populated overnight by the worker (~22:30 CET on weekdays).

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker
date	string	optional	ISO date (YYYY-MM-DD). Default: today.

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/digest?symbol=ASML"

Response

200 OK. `found:false` if no digest exists for that date.

{
  "found": true,
  "symbol": "ASML",
  "date": "2026-05-07",
  "digestNL": "ASML rapporteerde sterker dan verwacht…",
  "topEvents": [
    {
      "kind": "earnings",
      "headline": "Q1 beat"
    }
  ],
  "sentimentToday": "bullish",
  "sentimentSevenDay": "neutral",
  "direction": "up",
  "flaggedRisks": [],
  "publishedEarningsToday": true,
  "generatedAt": "2026-05-07T22:31:14Z"
}

GET/api/external/flagged-risksread:risks

Top flagged risks for a symbol

Returns risks the AI extracted from earnings calls, filings, and news — guidance cuts, supply concerns, regulatory issues, etc. Ordered by severity.

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker
limit	number	optionaldefault 5	Max risks

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/flagged-risks?symbol=ASML&limit=5"

Response

200 OK with risks array (may be empty).

{
  "symbol": "ASML",
  "risks": [
    {
      "kind": "guidance-cut",
      "text": "FY guidance cut by 5%",
      "severity": "high",
      "source": "earnings-call",
      "date": "2026-04-15"
    }
  ]
}

GET/api/external/insiderread:insider

Clustered insider trading activity

Returns insider trades with cluster detection (multiple insiders trading within a window). Useful for spotting coordinated buys or sells.

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker
days	number	optionaldefault 14	Lookback window
cluster_min	number	optionaldefault 3	Minimum insiders for a cluster

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/insider?symbol=ASML&days=14&cluster_min=3"

Response

200 OK with insider trade list.

{
  "symbol": "ASML",
  "insiderTrades": [
    {
      "officer": "John Smith, CFO",
      "shares": -5000,
      "date": "2026-05-06",
      "value": 2750000,
      "type": "sell"
    }
  ]
}

GET/api/external/fundamentalsread:fundamentals

Fundamental ratios and metrics

Returns key financial metrics: P/E, P/B, dividend yield, debt-to-equity, market cap, etc. Backed by Finnhub; refreshed daily.

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/fundamentals?symbol=ASML"

Response

200 OK with the latest snapshot.

{
  "symbol": "ASML",
  "peRatio": 38.2,
  "pbRatio": 17.4,
  "dividendYield": 0.91,
  "marketCapEUR": 280000000000,
  "asOf": "2026-05-07"
}

GET/api/external/published-earningsread:published-earnings

Published earnings reports + guidance

Returns historical published earnings: actual EPS, revenue, prior guidance, beat/miss flags.

Parameters

Name	Type	Required	Description
symbol	string	required	Ticker

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/published-earnings?symbol=ASML"

Response

200 OK with chronological earnings list (most recent first).

{
  "symbol": "ASML",
  "earnings": [
    {
      "date": "2026-04-15",
      "eps": 4.81,
      "epsEstimate": 4.65,
      "revenueBn": 6.42,
      "beat": true,
      "guidance": "Q2 revenue 6.0–6.5 Bn"
    }
  ]
}

Macro

GET/api/external/macroread:macro

Macro time-series

Daily values for major macro series: yields (US 2y/10y/30y), VIX, fed-funds, FX (EUR/USD, GBP/USD), oil (WTI). Sourced from FRED + Yahoo.

Parameters

Name	Type	Required	Description
series	string (fed-funds\|vix\|us-2y\|us-10y\|us-30y\|eur-usd\|gbp-usd\|wti-oil)	required	Series identifier
days	number	optionaldefault 30	Lookback window

Example request

curl -H "Authorization: Bearer ti_<token>" \
  "https://www.thickerpeek.com/api/external/macro?series=us-10y&days=30"

Response

200 OK with date/value pairs ordered most-recent first.

{
  "series": "us-10y",
  "data": [
    {
      "date": "2026-05-07",
      "value": 4.18
    },
    {
      "date": "2026-05-06",
      "value": 4.21
    }
  ]
}

Trading

POST/api/external/decisionswrite:decisions

Push trade setups (NovaTrade integration)

Receives a batch of trade setups produced by an external decisions engine (e.g. NovaTrade). Setups appear in the Decisions tab for the token's user.

Example request

curl -X POST https://www.thickerpeek.com/api/external/decisions \
  -H "Authorization: Bearer ti_<token>" \
  -H "Content-Type: application/json" \
  -d '{
       "setups": [
         {
           "symbol": "ASML",
           "side": "long",
           "entryZone": [
             820,
             830
           ],
           "stop": 805,
           "target": 880,
           "conviction": 78,
           "rationale": "Bull-flag breakout above 50d…"
         }
       ]
     }'

Response

200 OK with received-count.

{
  "ok": true,
  "received": 1
}