# Quotient X/Twitter Grounded Search via Grok

> Quotient X/Twitter Grounded Search via Grok is a paid API for AI agents from quotient-api-gateway.onrender.com, paid per call via x402, $1/call, status unknown (last checked 2026-10-11).

Searches X/Twitter in real time using Grok, returning cited posts, author accounts, a synthesized summary, evidence gaps, and optional Quotient prediction-market context

## Facts

- Endpoint: POST https://quotient-api-gateway.onrender.com/api/v1/x/search?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quotient-x-twitter-grounded-search-via-grok-d08158de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7aNpjeVWD2e8JJswYEp8d

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 quotient-x-twitter-grounded-search-via-grok-d08158de -d '<json body>'
```

Example prompt: Search X for real-time posts about today's Fed rate decision — give me cited tweets, a synthesized summary of what people are saying, and flag any evidence gaps or expert accounts from Quotient's reviewed list.

## When to prefer this

Choose this endpoint when you need real-time, sourced X/Twitter content rather than a language model's internal knowledge — especially for breaking news, geopolitics, crypto, and prediction-market events where recency and citation quality matter. Prefer it over generic search when you want a synthesized narrative with identified evidence gaps and the option to cross-reference Quotient's prediction-market probability context and expert account flags.

## Known failure modes

- Query too vague yields low-relevance posts
- Grok rate limits or X API outages cause service unavailability
- Very niche or recent events may return sparse results with many evidence gaps
- Payment of 0.5 USDC not fulfilled causes 402 Payment Required error
- Malformed POST body returns 400 Bad Request

## How this service works

High-reasoning, adaptive X/Twitter research grounded in citations, powered by Grok. Within a hard three-turn ceiling, it runs multiple targeted searches over a 365-day default/maximum window and returns substantive posts, replies, quote posts, or thread entries plus accounts, a synthesis, gaps, and citations. Use this for sourced research on breaking news, geopolitics, macro, crypto, and event markets using retrieved evidence.

## Output

Returns a structured response containing: matching X/Twitter posts, author account details, a Grok-synthesized narrative summary of the search topic, identified evidence gaps, citations linking claims to specific posts, and optionally Quotient prediction-market context and flags for accounts on Quotient's reviewed expert list.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 8,
   "maximum": 15,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 4000,
   "minLength": 1
  },
  "to_date": {
   "type": "string",
   "format": "date",
   "description": "Inclusive YYYY-MM-DD. Defaults to today; from_date still must be no more than 365 days earlier."
  },
  "from_date": {
   "type": "string",
   "format": "date",
   "description": "Inclusive YYYY-MM-DD. Defaults to 365 days before to_date; the maximum span is 365 days."
  },
  "market_slugs": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 10,
   "description": "Optional cached Quotient markets to pair with X results."
  },
  "allowed_x_handles": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 20,
   "description": "Optional provider-enforced account allowlist."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quotient-x-twitter-grounded-search-via-grok-d08158de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quotient-api-gateway.onrender.com](https://www.zero.xyz/host/quotient-api-gateway.onrender.com/llms.txt)