Sentimentrader APIsentimentrader.com ↗
Access Smart Money/Dumb Money confidence levels, SPX capitulation signals, macroeconomic conditions, and top trending stocks from SentimentTrader via API.
What is the Sentimentrader API?
This API exposes 5 endpoints covering SentimentTrader's core market sentiment indicators, including the Smart Money/Dumb Money confidence spread, historical SPX OHLCV data paired with confidence readings, and the Capitulative Panic Model with forward return statistics at horizons from one week to one year. The sentiment_summary endpoint returns current confidence levels and their spread in a single call, while capitulation_signals provides historical signal records with median, mean, and percent-positive statistics across multiple time horizons.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5b6f90fb-be09-41bf-8cf3-5fdbfaaeaa7a/sentiment_summary' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace sentimentrader-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.sentimenttrader_api import SentimentTrader, Sentiment, Chart, TrendSymbol, Macro, Capitulation, Signal
client = SentimentTrader()
# Get current sentiment snapshot
sentiment = client.sentiments.get()
print(sentiment.smart_money_confidence, sentiment.dumb_money_confidence, sentiment.smart_dumb_spread_returns)
# Get historical chart data for the last 30 days
chart = client.charts.get(from_date="2026-05-01")
print(chart.symbol, chart.total_records)
for record in chart.data:
print(record.date, record.close, record.smart_money_confidence, record.dumb_money_confidence)
# Get top trending stocks by optimism index
for symbol in client.trendlists.list():
print(symbol.symbol, symbol.trend_score, symbol.relative_trend, symbol.days_trend_8_or_more)
# Get macroeconomic conditions
macro = client.macros.get()
print(macro.total_records, macro.latest_macro_index.macro_index_model, macro.latest_macro_index.bear_market_probability)
# Get capitulation signals
cap = client.capitulations.get()
print(cap.total_signals)
latest = cap.latest_signal
print(latest.date, latest.one_week_pct, latest.one_year_pct)
Get current Smart Money and Dumb Money confidence levels and their spread. Returns whether smart money (commercial hedgers, institutional investors) and dumb money (retail traders, small speculators) are bullish, bearish, or neutral, along with the spread between them. A single snapshot with no parameters; the values update daily.
No input parameters required.
{
"type": "object",
"fields": {
"raw": "object containing the original upstream response fields",
"smart_money_verbiage": "string describing the smart money condition",
"dumb_money_confidence": "string indicating dumb money sentiment level",
"smart_money_confidence": "string indicating smart money sentiment level",
"smart_dumb_spread_returns": "number representing the spread between smart and dumb money as a percentage"
},
"sample": {
"data": {
"raw": {
"smart_verbiage": "excess",
"dumb_money_text": "optimistic",
"smart_money_text": "neutral",
"smart_dumb_returns": 0
},
"smart_money_verbiage": "excess",
"dumb_money_confidence": "optimistic",
"smart_money_confidence": "neutral",
"smart_dumb_spread_returns": 0
},
"status": "success"
}
}About the Sentimentrader API
Sentiment Indicators
The sentiment_summary endpoint returns the current state of Smart Money and Dumb Money confidence as descriptive strings (smart_money_confidence, dumb_money_confidence) plus a numeric smart_dumb_spread_returns field representing the percentage spread between the two. Smart money reflects commercial hedgers and institutional positioning; dumb money reflects retail traders and small speculators. For historical context, smart_dumb_money_chart returns daily SPX OHLCV records — open, high, low, close, volume — alongside both confidence indicator values going back to an optional from_date parameter in YYYY-MM-DD format. The most recent trading day may carry null indicator values if not yet calculated.
Trending Stocks and Macro Conditions
The top_trend_symbols endpoint returns the 10 assets with the highest Optimism Index Trend Score for the current day. Each record includes symbol, trend_score, relative_trend, and days_trend_8_or_more, giving a concrete count of how many days the symbol has held a high-optimism reading. The macroeconomic_conditions endpoint returns up to 60 monthly historical records, each with a macro_index_model score (0 = weak economy, 1 = strong economy) and bear_market_probability. The response surfaces two convenience objects — latest_macro_index and latest_bear_market_probability — so you can read current conditions without iterating the full array.
Capitulation Signals
The capitulation_signals endpoint surfaces every historical instance of the Capitulative Panic Model firing on SPX, together with realized forward returns at seven horizons: 1_week_pct, 2_weeks_pct, 1_month_pct, 2_months_pct, 3_months_pct, and 6_month through one year. The statistics object aggregates these into median, mean, pct_positive, avg_gain, and avg_loss at each horizon, allowing backtested probability analysis without additional computation. Recent signals may show null forward-return values for horizons that have not yet elapsed.
The Sentimentrader API is a managed, monitored endpoint for sentimentrader.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sentimentrader.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official sentimentrader.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Alert when
smart_dumb_spread_returnscrosses a threshold, signaling a potential contrarian setup. - Chart historical SPX price against Smart Money and Dumb Money confidence values using
smart_dumb_money_chart. - Screen for high-conviction bullish setups by filtering
top_trend_symbolsondays_trend_8_or_more. - Track monthly changes in
macro_index_modelandbear_market_probabilityto adjust portfolio risk allocation. - Backtest entry rules triggered by capitulation signals using the pre-computed forward return percentages from
capitulation_signals. - Build a dashboard that surfaces the current
bear_market_probabilityalongside thesmart_dumb_spread_returnsin a single view. - Quantify historical edge of panic-buying setups by reading
pct_positiveandavg_gainfrom thestatisticsobject.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SentimentTrader have an official developer API?+
What does `capitulation_signals` return and how far back does the history go?+
statistics object. The total_signals field tells you the count of records returned. Note that recent signals will have null values for horizons that haven't yet elapsed.Can I retrieve Smart Money/Dumb Money data for assets other than SPX?+
smart_dumb_money_chart endpoint is fixed to SPX — the symbol field always returns SPX. The sentiment_summary endpoint also reflects SPX-level composite readings. Individual equity sentiment data is not currently exposed. You can fork this API on Parse and revise it to add asset-specific sentiment endpoints if that data is needed.How fresh is the data from `top_trend_symbols` and `macroeconomic_conditions`?+
top_trend_symbols are updated daily. The macroeconomic_conditions endpoint returns monthly data — the data array covers the last 60 monthly records, and the latest_macro_index object reflects the most recent monthly reading. Intraday or weekly macro granularity is not available from this endpoint.