# Sentimentrader — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track real-time market sentiment and investor behavior by accessing Smart Money/Dumb Money confidence levels, trending stocks, and capitulation signals to inform your trading decisions. Monitor macroeconomic conditions alongside sentiment indicators to get a comprehensive view of current market psychology and potential turning points.

**Category:** Finance & Markets | **Website:** [sentimentrader.com/](https://sentimentrader.com/) | **Docs:** [parse.bot/marketplace/518c0984-f34c-4d7e-a462-b7018df87ced/sentimentrader-com-api](https://parse.bot/marketplace/518c0984-f34c-4d7e-a462-b7018df87ced/sentimentrader-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-sentimentrader-com-api-518c0984/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### capitulation_signals

Get historical SPX capitulation signals (Capitulative Panic Model) with forward return analysis at various time horizons (1 week through 1 year). Includes summary statistics (median, mean, percent positive, average gain, average loss). Recent signals may have null values for forward periods that have not yet elapsed.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sentimentrader-com-api-518c0984/capitulation_signals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### macroeconomic_conditions

Get macroeconomic conditions data including the Macro Index Model (economic health score 0-1) and Bear Market Probability Model. Returns the latest values plus the last 60 monthly historical records. The Macro Index ranges from 0 (weak economy) to 1 (strong economy).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sentimentrader-com-api-518c0984/macroeconomic_conditions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### sentiment_summary

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sentimentrader-com-api-518c0984/sentiment_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### smart_dumb_money_chart

Get historical daily chart data for SPX with Smart Money and Dumb Money confidence indicator values. Returns OHLCV price data alongside both confidence indicators over time. The most recent trading day may have null indicator values if they have not yet been calculated.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_date` | string | No | Start date for historical data in YYYY-MM-DD format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sentimentrader-com-api-518c0984/smart_dumb_money_chart \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_date":"<string>"}'
```

### top_trend_symbols

Get the top 10 stocks/assets ranked by Optimism Index Trend Score. Shows which assets have the strongest bullish sentiment trends based on proprietary scoring. Updated daily.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sentimentrader-com-api-518c0984/top_trend_symbols \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```