# SentimentAlpha Social Arbitrage Alert API

> SentimentAlpha Social Arbitrage Alert API is a paid API for AI agents from sentimentalpha.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Analyzes real-time X/Twitter sentiment for specified tickers and returns trading signals, narrative velocity, and contrarian alerts when configurable thresholds are crossed

## Facts

- Endpoint: POST https://sentimentalpha.ai/v1/alert-alpha
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sentimentalpha-social-arbitrage-alert-api-b8091561
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YxD118Sw6GZY1hXtpN1kO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sentimentalpha-social-arbitrage-alert-api-b8091561 -d '<json body>'
```

Example prompt: Check SentimentAlpha right now for TSLA and NVDA — alert me if the X/Twitter sentiment crosses a bullish threshold of 0.7 or a bearish threshold of -0.5, and flag any contrarian signals or sudden narrative shifts.

## When to prefer this

Choose this endpoint when you need real-time, social-media-driven sentiment signals for trading decisions and want to monitor specific ticker conditions with threshold-based alerting. It is especially suitable for AI trading agents that need affordable alternative-data sentiment versus expensive platforms like RavenPack or QuiverQuant, and for strategies that emphasize narrative velocity and contrarian signals from X/Twitter specifically.

## Known failure modes

- Ticker not found or unrecognized — empty or null result for that watchlist entry
- Query too vague — low-confidence sentiment scores returned
- Rate limit exceeded — 402 payment required or quota exhausted
- Grok API upstream outage — 503 or timeout
- Invalid watchlist schema — missing ticker, condition, or threshold fields cause 400 error
- Threshold values out of range — malformed condition triggers validation error

## How this service works

SentimentAlpha.ai delivers real-time X/Twitter sentiment intelligence via Grok API. Automate Social Arbitrage: spot cultural trend shifts, narrative velocity, and contrarian signals BEFORE Wall Street. The affordable alternative to TickerTrends, QuiverQuant, and RavenPack for AI agents. x402 micropayments on Base USDC.

## Output

Returns sentiment scores, alert signals, and narrative velocity indicators for each ticker on the watchlist, including contrarian flags and cultural trend shift data derived from real-time X/Twitter posts via Grok API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  },
  "watchlist": {
   "type": "array",
   "description": "Array of {ticker, condition, threshold}"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sentimentalpha-social-arbitrage-alert-api-b8091561/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sentimentalpha.ai](https://www.zero.xyz/host/sentimentalpha.ai/llms.txt)