POST

/api/v1/x/search

Structured Grok 4.5 search over X

Price $0.50 per callAuth x-quotient-api-key or x402Limit 1/s · 6/min · 100/day

Parameters

None.

Response fields

Field	Type	Meaning
query	string
summary	string
posts	XSearchPost[]
accounts	object[]
quotient_markets	QuotientMarketContext[]
gaps	string[]
citations	string[]
meta	object

Billing and limits

Calls are billed to prepaid credits, or per call over x402. The price above is the reference price; the 402 challenge returned at request time is what a call actually costs.

One request may be in flight at a time, and request starts must be at least one second apart. A rejected 429 is not billed. See rate limits.

curl

curl -H "x-quotient-api-key: qt_…" \
  "https://quotient-api-gateway.onrender.com/api/v1/x/search"

200 · application/json

{
  "query": "…",
  "summary": "…",
  "posts": [
    {
      "post_id": "…",
      "url": "…",
      "author_handle": "…",
      "author_name": "…",
      "published_at": "…",
      "text": "…",
      "relevant_excerpt": "…",
      "relevance": "…",
      "stance": "supports_yes",
      "linked_market_slugs": [
        "…"
      ],
      "author_metadata": {
        "handle": "…",
        "display_name": "…",
        "x_user_id": "…",
        "current_username": "…",
        "is_quotient_expert": false,
        "quotient_expert": {
          "designation": "reviewed_expert",
          "policy_version": "…"
        }
      }
    }
  ],
  "accounts": [
    {
      "handle": "…",
      "display_name": "…",
      "description": "…",
      "profile_url": "…",
      "quotient_metadata": {
        "handle": "…",
        "display_name": "…",
        "x_user_id": "…",
        "current_username": "…",
        "is_quotient_expert": false,
        "quotient_expert": {
          "designation": "reviewed_expert",
          "policy_version": "…"
        }
      }
    }
  ],
  "quotient_markets": [
    {
      "venue": "polymarket",
      "nativeMarketId": "…",
      "nativeEventId": "…",
      "seriesTicker": "…",
      "marketKey": "…",
      "slug": "…",
      "marketUrl": "…",
      "sourceUrl": "…",
      "market_id": "…",
      "question": "…",
      "resolution_criteria": "…",
      "resolution_source": "…",
      "end_date": "…",
      "condition_id": "…",
      "status": "open",
      "resolved_yes": false,
      "venue_data": {
        "yes_odds": 0,
        "volume_24h": 0
      },
      "quotient_url": "…",
      "forecast": {
        "venue": "polymarket",
        "market": {
          "venue": "polymarket",
          "nativeMarketId": "…",
          "nativeEventId": "…",
          "seriesTicker": "…",
          "marketKey": "…",
          "slug": "…",
          "marketUrl": "…",
          "sourceUrl": "…"
        },
        "id": "…",
        "probability": 0,
        "created_at": "…",
        "headline": "…",
        "thesis": "…",
        "resolution_pathway": {
          "criteria": "…",
          "crux": "…",
          "deadline": "…",
          "source": "…"
        },
        "delta_from_prior": 0,
        "delta_reasoning": "…",
        "refresh_reason": "…",
        "relationships": {
          "assets": [
            {}
          ],
          "markets": [
            {}
          ],
          "signals": [
            {}
          ],
          "truncated": {
            "assets": false,
            "markets": false,
            "signals": false
          }
        }
      },
      "relationships": {
        "assets": [
          {}
        ],
        "markets": [
          {}
        ],
        "signals": [
          {}
        ],
        "truncated": {
          "assets": false,
          "markets": false,
          "signals": false
        }
      }
    }
  ],
  "gaps": [
    "…"
  ],
  "citations": [
    "…"
  ],
  "meta": {}
}