# SentimentAlpha Manipulation Alpha API

> SentimentAlpha Manipulation Alpha 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 a given query and time window to surface manipulation signals, narrative velocity, and contrarian trading opportunities

## Facts

- Endpoint: POST https://sentimentalpha.ai/v1/manipulation-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-manipulation-alpha-api-23c4ec46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mf1GI7xdoK7oGXOAhdN9V

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-manipulation-alpha-api-23c4ec46 -d '<json body>'
```

Example prompt: Check SentimentAlpha for manipulation signals around $NVDA on X over the last 4 hours — I want to know if there's coordinated narrative pushing or any contrarian signals before I make a trade.

## When to prefer this

Use this endpoint when you need real-time, pre-market social sentiment intelligence specifically from X/Twitter to detect manipulation patterns or contrarian signals ahead of price moves. Prefer this over news sentiment APIs or traditional NLP tools when the goal is trading-oriented social arbitrage, especially for retail-driven assets like meme stocks or crypto where X sentiment leads price action.

## Known failure modes

- Query too broad or ambiguous — returns low-confidence or empty signal set
- Time window not recognized or out of supported range — 400 error
- Grok API upstream failure — 502 or degraded signal quality
- Rate limit exceeded for micropayment tier — 429 error
- Payment not processed or insufficient USDC balance — 402 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 intelligence for the queried topic/ticker, including manipulation alpha signals, narrative velocity metrics, contrarian indicators, 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"
  },
  "time_window": {
   "enum": [
    "1h",
    "4h",
    "12h",
    "24h",
    "7d"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sentimentalpha-manipulation-alpha-api-23c4ec46/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)