{"uid":"cap_v_uZAgch55uaUdbwmpITN","slug":"mangrove-x-post-counts-by-symbol-4ada2164","name":"Mangrove X Post Counts by Symbol","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/social/x-post-counts/%7Bsymbol%7D?utm_source=zero.xyz","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"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Asset symbol, e.g. BTC or ETH."}}},"queryParams":{"type":"object","properties":{"x_query":{"type":"string","default":"all","description":"all (default) or en_original (no replies, English only)."},"days_back":{"type":"integer","default":7,"description":"Window in days ending now, 1 to 31."},"granularity":{"type":"string","default":"hour","description":"hour or day."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mF4I5aD0FB48FRNWIOF4D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-series post counts on X (Twitter) for a given crypto asset symbol over a configurable lookback window and granularity.","exampleAgentPrompt":"Pull the hourly X post counts for BTC over the past 7 days — only original English posts, no replies.","exampleUseCases":[{"title":"Crypto social buzz spike detection","prompt":"Get me the hourly X post counts for ETH over the last 14 days so I can see if there were any sudden spikes in social activity."},{"title":"Daily social volume report for token","prompt":"Fetch the daily X post count for SOL for the past 30 days — I want to compare weekend vs weekday social volume."},{"title":"Pre-trade social sentiment check","prompt":"What's the X post volume for BTC over the last 3 days broken down by hour? Only include original English posts, skip replies."}],"resultDescription":"A time-series array of X (Twitter) post counts for the requested asset symbol, bucketed by the specified granularity (hour or day) over the requested lookback window. Each data point typically includes a timestamp and a count of posts mentioning the symbol, optionally filtered to English-only original posts.","failureModes":["Invalid or unrecognized symbol returns an error or empty result","days_back out of range (less than 1 or greater than 31) causes a validation error","Unsupported granularity value other than 'hour' or 'day' causes a bad request error","Payment failure via x402 protocol results in 402 response and no data","Rate limiting may apply if many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need quantitative social volume data for a crypto asset specifically on X (Twitter), with flexible time windowing and hourly or daily granularity. It is ideal for detecting social buzz spikes, correlating social activity with price movements, or building social sentiment dashboards. Prefer this over generic social listening tools when you need structured, time-bucketed post count data for crypto symbols at low per-call cost via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:35:03.305Z","isFirstParty":false,"canonicalSlug":"mangrove-x-post-counts-by-symbol-4ada2164"}