# Crypto X (Twitter) Social Search

> Crypto X (Twitter) Social Search is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31).

Searches recent X (Twitter) posts for crypto keywords, tickers, or handles and returns posts with engagement metrics plus a synthesized signal including sentiment, top claim, and notable terms.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/crypto/x-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-x-twitter-social-search-9d581c2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F69m6lkjLf1KJ4Kr-W-E3

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 crypto-x-twitter-social-search-9d581c2f
```

Example prompt: Search X for the last 10 English posts mentioning $ETH sorted by recency and tell me the overall sentiment — are people bullish or bearish right now?

## When to prefer this

Use this endpoint when an AI agent needs real-time X (Twitter) social sentiment or post data about crypto tokens, projects, or handles, especially when the agent cannot access X directly. Prefer this over general web search when you need structured engagement metrics, per-post author data, and a pre-computed sentiment signal. It is ideal for trading agents that need to factor social buzz into decisions, or for monitoring what influential crypto accounts are saying about a specific ticker.

## Known failure modes

- 4xx/5xx errors are not charged — invalid query or missing required parameter returns 4xx
- No posts found for query in last 7 days returns empty posts array
- Rate limits from upstream X API may cause 429 or degraded responses
- Date range outside last 7 days silently constrained or returns no results
- Very broad queries may hit X API result caps and return fewer than requested posts

## How this service works

Live X (Twitter) search for agents that cannot read X: q=keyword|$TICKER|from:handle (X search operators ok), limit=1-20 (default 10), lang=en|ko|.., sort=recency|relevancy. Returns posts [{id,url,text,author{handle,name,followers,verified},metrics{likes,reposts,replies,quotes},created_at,lang}] plus signal {top_claim (most-engaged post: the tip/claim), sentiment bullish|bearish|neutral with score, top_terms, cashtags, notable_handles, engagement}. Last 7 days, no retweets. 4xx/5xx not charged.

## Output

Returns a list of up to 20 posts (each with id, URL, text, author handle/name/followers/verified status, likes/reposts/replies/quotes metrics, created_at, and language) plus a synthesized signal object containing: the top claim (most-engaged post text, URL, author), overall sentiment (bullish/bearish/neutral) with a numeric score, top terms, cashtags mentioned, notable handles, and aggregate engagement counts. Also includes a pagination token for next page and suggested sibling endpoint paths.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "examples": [
        "bitcoin",
        "$ETH",
        "x402",
        "from:base"
       ],
       "maxLength": 200,
       "minLength": 1,
       "description": "X search query (operators ok); or use the twit.sh-style filters below"
      },
      "to": {
       "type": "string",
       "description": "Replying to handle"
      },
      "from": {
       "type": "string",
       "description": "From handle"
      },
      "lang": {
       "type": "string",
       "maxLength": 5,
       "description": "Language filter e.g. en, ko"
      },
      "sort": {
       "enum": [
        "recency",
        "relevancy"
       ],
       "type": "string",
       "description": "Default relevancy"
      },
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Posts (default 10)"
      },
      "since": {
       "type": "string",
       "description": "YYYY-MM-DD (last 7 days)"
      },
      "until": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "words": {
       "type": "string",
       "description": "All of these words"
      },
      "phrase": {
       "type": "string",
       "description": "Exact phrase"
      },
      "anyWords": {
       "type": "string",
       "description": "Any of these words (space/comma separated)"
      },
      "hashtags": {
       "type": "string",
       "description": "Hashtags (comma separated, # optional)"
      },
      "minLikes": {
       "type": "integer",
       "minimum": 0
      },
      "username": {
       "type": "string",
       "description": "Timeline shortcut: posts from this handle"
      },
      "noneWords": {
       "type": "string",
       "description": "None of these words"
      },
      "mentioning": {
       "type": "string",
       "description": "Mentions handle"
      },
      "minReplies": {
       "type": "integer",
       "minimum": 0
      },
      "minReposts": {
       "type": "integer",
       "minimum": 0
      },
      "next_token": {

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "n": 1,
  "q": "bitcoin",
  "next": [
   "/crypto/prices?symbols=BTC",
   "/crypto/prediction-markets?q=bitcoin",
   "/crypto/market-pulse"
  ],
  "posts": [
   {
    "id": "1851234567890123456",
    "url": "https://x.com/example/status/1851234567890123456",
    "lang": "en",
    "text": "$BTC ETF inflows strong again, ATH watch",
    "author": {
     "name": "Example",
     "handle": "example",
     "verified": true,
     "followers": 250000
    },
    "metrics": {
     "likes": 1200,
     "quotes": 12,
     "replies": 85,
     "reposts": 210
    },
    "created_at": "2026-10-30T01:20:00Z"
   }
  ],
  "signal": {
   "cashtags": [
    "$BTC"
   ],
   "sentiment": "bullish",
   "top_claim": {
    "url": "https://x.com/example/status/1851234567890123456",
    "text": "$BTC ETF inflows strong again, ATH watch",
    "handle": "example"
   },
   "top_terms": [
    "etf",
    "inflows",
    "ath"
   ],
   "engagement": {
    "likes": 1200,
    "replies": 85,
    "reposts": 210
   },
   "notable_handles": [
    {
     "handle": "example",
     "followers": 250000
    }
   ],
   "sentiment_score": 0.4
  },
  "source": "x-api-v2-recent-search",
  "updated_at": "2026-10-30T01:50:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-x-twitter-social-search-9d581c2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)