# Sentimentrader — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/sentimentrader/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/sentimentrader/capitulation-signals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/sentimentrader/macroeconomic-conditions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/sentimentrader/sentiment-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/sentimentrader/smart-dumb-money-chart \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/sentimentrader/top-trend-symbols \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.