{"uid":"cap_Ol0uMUhrnTf_1JVwFABcv","slug":"social-sentiment-c1c0f693","name":"social-sentiment","description":"Composite bull/bear sentiment for a crypto ticker or topic, fused across three ToS-clean sources: Farcaster cast sentiment (open-protocol hub), our crypto-news + Fear&Greed composite, and GDELT world-tone. Returns a normalized score, a per-source breakdown, 24h/7d deltas and a confidence (how much data is under the signal) — so you see which source drives it and how thin the signal is.","url":"https://api.agentstools.dev/social/sentiment","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"sym":{"type":"string","description":"Crypto ticker or coin name (BTC, ETH, SOL, DEGEN, bitcoin, ...). Provide sym OR query."},"query":{"type":"string","description":"Free-text topic instead of a ticker (e.g. 'base l2'). Provide sym OR query."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KD6deOPjyd_VagOJqtwST","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a composite bull/bear sentiment score for a crypto ticker or topic, fused from Farcaster cast sentiment, crypto-news/Fear&Greed index, and GDELT world-tone, with per-source breakdown and 24h/7d deltas.","exampleAgentPrompt":"What's the current bull/bear social sentiment for Solana — pull in the Farcaster, news, and GDELT breakdown and tell me which source is driving it and how confident the signal is.","exampleUseCases":[{"title":"Pre-trade sentiment check for BTC","prompt":"Before I make a move, what's the composite social sentiment for Bitcoin right now? I want to see the per-source breakdown and whether it's shifted in the last 24 hours."},{"title":"Monitoring Base L2 community mood","prompt":"Check the social sentiment for 'base l2' as a topic — is the broader conversation bullish or bearish, and how thin is the signal?"},{"title":"Weekly crypto sentiment report for ETH","prompt":"Give me the 7-day sentiment delta for ETH, including the Farcaster and GDELT contributions, so I can see how the mood has evolved over the past week."}],"resultDescription":"A normalized bull/bear sentiment score for the queried ticker or topic, a breakdown of the score by source (Farcaster, crypto-news/Fear&Greed composite, GDELT world-tone), 24-hour and 7-day deltas showing how sentiment has shifted, and a confidence value indicating how much underlying data backs the signal.","failureModes":["Missing both sym and query parameters — returns error requiring one to be provided","Unknown or unsupported ticker symbol — may return low-confidence score or empty data","Insufficient data for thin/new tokens — low confidence score indicating sparse signal","Rate limiting or payment failure (x402) — returns 402 requiring USDC payment","GDELT or Farcaster source temporarily unavailable — partial breakdown with missing source"],"whenToPreferThis":"Choose this endpoint when you need a multi-source, fused sentiment signal for a crypto asset or topic rather than a single-source reading. It is especially useful when you want to understand which source (social/Farcaster, news/Fear&Greed, or global media/GDELT) is driving sentiment, or when you need confidence weighting to know how reliable the signal is for thin or emerging tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:00:27.727Z","isFirstParty":false}