# Mangrove X Post Counts by Symbol

> Mangrove X Post Counts by Symbol is a paid API for AI agents from api.mangrovedeveloper.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-04).

Returns time-series post counts on X (Twitter) for a given crypto asset symbol over a configurable lookback window and granularity.

## Facts

- Endpoint: GET https://api.mangrovedeveloper.ai/api/v1/social/x-post-counts/%7Bsymbol%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mangrove-x-post-counts-by-symbol-4ada2164
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v_uZAgch55uaUdbwmpITN

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 mangrove-x-post-counts-by-symbol-4ada2164
```

Example prompt: Pull the hourly X post counts for BTC over the past 7 days — only original English posts, no replies.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Developer references for Mangrove Agent, API contracts, MCP and AI integrations.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mangrove-x-post-counts-by-symbol-4ada2164/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mangrovedeveloper.ai](https://www.zero.xyz/host/api.mangrovedeveloper.ai/llms.txt)