# MapleAI X Sentiment Analysis

> MapleAI X Sentiment Analysis is a paid API for AI agents from base.mapleai.shop, paid per call via x402, $0.0335/call, status unknown (last checked 2026-10-11).

Analyzes real-time sentiment on X (Twitter) for a given token, project, or narrative, returning a scored verdict with supporting post evidence

## Facts

- Endpoint: POST https://base.mapleai.shop/v1/x/sentiment?utm_source=zero.xyz
- Price: $0.0335/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapleai-x-sentiment-analysis-68226108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rMOO0JKoIagIWnvskwYNb

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 mapleai-x-sentiment-analysis-68226108 -d '<json body>'
```

Example prompt: What's the current sentiment on X about the x402 protocol? Look back over the last 48 hours, show me up to 8 example posts, and only include tweets with at least 10 likes.

## When to prefer this

Choose this endpoint when you need structured, scored social sentiment on X specifically for crypto tokens, DeFi projects, or web3 narratives — especially when you want evidence posts with engagement metrics and a clear bullish/bearish verdict rather than raw text. Prefer over generic LLM sentiment prompts when you need aggregated distribution data across many posts and pay-per-request economics via x402.

## Known failure modes

- Topic not found or no recent posts available — returns empty distribution or low posts_evaluated count
- hours_back exceeds maximum of 168 — request rejected with validation error
- max_examples exceeds maximum of 10 — request rejected
- Payment failure via x402 — 402 response requiring USDC on Base before proceeding
- Rate limiting or upstream X API unavailability — service error response
- min_engagement set very high with obscure topic — may return zero qualifying examples

## How this service works

14 chat models (GPT + Claude), 7 image models, and Jev structured decisions. Pay per request in USDC on Base with x402.

## Output

Returns a JSON object with a numeric sentiment score (e.g. 0.6), a verdict string (bullish/bearish/neutral), an array of driver phrases, a distribution breakdown of bullish/bearish/neutral post counts, the total number of posts evaluated, and up to max_examples posts each with URL, likes count, stance, and a snippet of the post text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topic": {
   "type": "string",
   "maxLength": 200,
   "description": "Token, project or narrative to assess"
  },
  "hours_back": {
   "type": "integer",
   "default": 24,
   "maximum": 168,
   "minimum": 1
  },
  "max_examples": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Evidence posts in the answer; drives the price"
  },
  "min_engagement": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "When > 0, keyword searches use min_faves:N to skip low-engagement noise"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 0.6,
  "topic": "x402 protocol",
  "object": "x.sentiment",
  "drivers": [
   "agent payments momentum"
  ],
  "verdict": "bullish",
  "examples": [
   {
    "url": "https://x.com/user/status/123",
    "likes": 420,
    "stance": "bullish",
    "snippet": "..."
   }
  ],
  "distribution": {
   "bearish": 3,
   "bullish": 14,
   "neutral": 5
  },
  "posts_evaluated": 22
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapleai-x-sentiment-analysis-68226108/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base.mapleai.shop](https://www.zero.xyz/host/base.mapleai.shop/llms.txt)