{"uid":"cap_XXxGsahe9VlrVD6imZSjl","slug":"octodamus-x-sentiment-divergence-dbd31ea1","name":"Octodamus X Sentiment Divergence","description":"Octodamus X Sentiment Divergence -- pay-per-call x402 endpoint on Base. Preview: https://api.octodamus.com/v2/x_sentiment/divergence/preview","url":"https://api.octodamus.com/v2/x_sentiment/divergence","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["method"],"properties":{"method":{"type":"string","const":"GET"},"headers":{"type":"object","required":["PAYMENT-SIGNATURE"],"properties":{"PAYMENT-SIGNATURE":{"type":"string","description":"x402 EIP-3009 USDC payment signature (Base mainnet)"}}}}},"output":{"type":"object","properties":{"action":{"enum":["BUY","SELL","HOLD"],"type":"string"},"signal":{"enum":["BULLISH","BEARISH","NEUTRAL"],"type":"string"},"btc_trend":{"enum":["UP","DOWN","SIDEWAYS"],"type":"string"},"reasoning":{"type":"string"},"confidence":{"type":"number","maximum":1,"minimum":0},"fear_greed":{"type":"number","maximum":100,"minimum":0},"polymarket_edge":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"asset":"BTC"},"response":{"agent":"X_Sentiment_Agent","asset":"BTC","score":40,"product":"crowd_divergence","crowd_pct":0,"signature":"SX28voy6Pdbyi70Dv19pVeouzaXzmxFChYW1Xrdg5mix//Y9HacPkZaxowMIQf4jYsnXmrA91PZX0UYMVyqkDw==","signed_at":"2026-06-18T06:21:45.541158Z","timestamp":"2026-06-18T06:21:45.540874Z","powered_by":"X_Sentiment_Agent (@octodamusai ecosystem) | Grok real-time","signer_pubkey":"qw0tIly/2xQAyOKbV4DpzaR2D8mTEKFvkbxw7XayjVs=","interpretation":"CAUTION: 0% consensus forming. Watch for reversal.","crowd_direction":"BEARISH","divergence_type":"CAUTION","price_change_24h":-0.93,"price_contradicts_crowd":false}},"exampleRequest":{"asset":"BTC"},"tags":["x402"],"displayCostAmount":"0.35","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sniAqIZPA9M5n2D5fjheB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.35","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a crowd sentiment divergence score for a given asset (e.g. BTC) based on real-time X (Twitter) sentiment analysis, indicating whether crowd sentiment contradicts price action.","exampleAgentPrompt":"What's the current X sentiment crowd divergence score for BTC — is social media sentiment going against the price action right now?","exampleUseCases":[{"title":"Monitor Bitcoin contrarian signals daily","prompt":"Check if there's a crowd sentiment divergence on BTC right now — I want to know if what people are saying on X contradicts where the price is actually moving."},{"title":"Alert on extreme crowd-price disagreement","prompt":"Get me the Octodamus divergence score for Bitcoin and let me know if the crowd is heavily bearish while the price is rising or vice versa — I'm looking for those contrarian setups."},{"title":"Track social sentiment vs market action","prompt":"What does the current X sentiment divergence look like for BTC? I need to see if Twitter users are optimistic while the price drops, or pessimistic while it rallies up."}],"resultDescription":"Returns a divergence score (0-100), crowd direction (BULLISH/BEARISH), divergence type (e.g. NO_SIGNAL, BULLISH_DIVERGENCE, BEARISH_DIVERGENCE), crowd sentiment percentage, whether price contradicts crowd, 24h price change, a human-readable interpretation string, and a cryptographically signed timestamp with signer pubkey for verification.","failureModes":["Invalid or unsupported asset symbol returns an error or empty result","Rate limit exceeded (500 req/day free tier) returns 429","Payment not provided or insufficient USDC ($0.35) returns 402","Network or upstream Grok data unavailability may cause delayed or null response"],"whenToPreferThis":"Use this endpoint when you need to detect whether crowd sentiment on X (Twitter) is diverging from an asset's price movement — a classic contrarian signal. Ideal for crypto (BTC) and potentially other supported assets. Prefer this over generic sentiment APIs when you specifically want a divergence/contradiction signal with cryptographic signing for auditability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:07.130Z","isFirstParty":false}