sentimentrader.com APIsentimentrader.com ↗
Access Smart Money/Dumb Money confidence levels, capitulation signals, macroeconomic conditions, and top trending stocks from SentimentTrader via a structured API.
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'
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.
No input parameters required.
{
"type": "object",
"fields": {
"raw": "object containing the original API response fields",
"smart_money_verbiage": "string describing the smart money condition (e.g. 'excess')",
"dumb_money_confidence": "string indicating dumb money sentiment level (e.g. 'very optimistic', 'bullish', 'bearish')",
"smart_money_confidence": "string indicating smart money sentiment level (e.g. 'neutral', 'bullish', 'bearish')",
"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": "very optimistic",
"smart_money_text": "neutral",
"smart_dumb_returns": -0.6
},
"smart_money_verbiage": "excess",
"dumb_money_confidence": "very optimistic",
"smart_money_confidence": "neutral",
"smart_dumb_spread_returns": -0.6
},
"status": "success"
}
}About the sentimentrader.com API
The SentimentTrader API exposes 5 endpoints covering market sentiment indicators drawn from SentimentTrader.com's public dashboard. The sentiment_summary endpoint returns current Smart Money and Dumb Money confidence levels along with their spread, while smart_dumb_money_chart provides daily SPX OHLCV data paired with both confidence indicators going back to any specified start date. Additional endpoints cover macroeconomic health scores, capitulation signals with forward return statistics, and the top 10 trending stocks by Optimism Index Trend Score.
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 smart_dumb_spread_returns value expressed as a percentage. This spread is a key signal: a wide positive spread (smart money bullish, dumb money bearish) has historically preceded market recoveries. The smart_money_verbiage field provides a plain-language label such as 'excess' for the current smart money condition.
Historical Chart Data and Macro Conditions
The smart_dumb_money_chart endpoint returns an array of daily records for SPX, each containing date, open, high, low, close, volume, dumb_money_confidence, and smart_money_confidence. An optional from_date parameter (YYYY-MM-DD) controls how far back the data goes. The latest object in the response isolates the most recent data point for quick access without iterating the full array.
The macroeconomic_conditions endpoint returns the last 60 monthly records, each with a macro_index_model score (0–1 economic health scale) and a bear_market_probability value. The latest_macro_index and latest_bear_market_probability objects surface the most recent readings directly, so you do not need to sort the array.
Capitulation Signals and Trending Stocks
The capitulation_signals endpoint returns historical SPX Capitulative Panic Model signals with forward return percentages at horizons from 1 week (1_week_pct) through 6 months (6_month). The statistics object summarizes all signals by median, mean, pct_positive, avg_gain, and avg_loss at each horizon — useful for backtesting or displaying aggregate signal performance. Recent signals will show null for forward return fields where the horizon has not yet elapsed. The top_trend_symbols endpoint lists the 10 assets with the highest Optimism Index Trend Scores, including each symbol's trend_score, relative_trend, and days_trend_8_or_more count.
- Overlay Smart Money and Dumb Money confidence on an SPX price chart using
smart_dumb_money_chartOHLCV and confidence fields. - Alert traders when
smart_dumb_spread_returnscrosses a threshold indicating an extreme sentiment divergence. - Build a macro dashboard that tracks
macro_index_modelandbear_market_probabilityover the last 60 months. - Display aggregate capitulation signal statistics (
pct_positive,avg_gain,avg_loss) for each forward return horizon in a research report. - Screen for high-momentum sentiment candidates using
trend_scoreanddays_trend_8_or_morefromtop_trend_symbols. - Monitor
latest_signalfromcapitulation_signalsto detect the most recent panic event and its early forward return readings. - Backtest entry rules by filtering
capitulation_signalsdata for signal dates and pairing them with subsequent price data.
| 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 | 250 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 the `smart_dumb_money_chart` endpoint return, and how do I control the date range?+
date, open, high, low, close, volume, dumb_money_confidence, and smart_money_confidence. Pass the optional from_date parameter in YYYY-MM-DD format to set the start of the range. The latest object in the response always contains the most recent record regardless of the date range.Why do some `capitulation_signals` records have null values for forward return fields?+
1_week_pct, 1_month_pct, or 6_month are null when the corresponding time horizon has not yet elapsed since the signal date. This is expected behavior for the most recent signals in the dataset, not a data gap.Does the API cover individual stock sentiment data beyond the top 10 trending symbols?+
top_trend_symbols endpoint returns only the 10 assets with the highest Optimism Index Trend Scores at the time of the request. Broader per-symbol sentiment history is not exposed. You can fork this API on Parse and revise it to add an endpoint targeting additional symbol-level sentiment data.Does the `macroeconomic_conditions` endpoint return data beyond the last 60 monthly records?+
data array is fixed at the last 60 monthly records. The total_records field indicates how many historical records exist in total, but only 60 are returned per call. If deeper history is needed, you can fork this API on Parse and revise the endpoint to adjust the record window.