# X/Twitter Watch — Cursor-Based Change Monitor

> X/Twitter Watch — Cursor-Based Change Monitor is a paid API for AI agents from clink-lithium-vault.fly.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Monitors X/Twitter for new tweets matching a search query since a given cursor or timestamp, returning only new results plus an AI-generated change summary.

## Facts

- Endpoint: GET https://clink-lithium-vault.fly.dev/x/watch?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-twitter-watch-cursor-based-change-monitor-0c82358e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Cvb-9C1uMoOfGN5DU7UC9

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 x-twitter-watch-cursor-based-change-monitor-0c82358e
```

Example prompt: Watch X/Twitter for any new tweets mentioning 'lithium battery shortage' since tweet ID 1877000000000000000 and give me a summary of what's changed.

## When to prefer this

Choose this endpoint when you need incremental, cursor-based monitoring of X/Twitter — i.e., you want only NEW tweets since the last check without re-processing old ones. Ideal for agentic polling loops, brand alerting, and competitor tracking where avoiding duplicate reads is critical. Prefer over a plain search endpoint when you need change detection plus an AI summary rather than a raw result set.

## Known failure modes

- Missing required 'query' parameter returns an error
- Invalid or malformed 'since' value (bad ISO date or non-numeric tweet ID) may return an error or fall back to baseline
- No new tweets since cursor returns new_count: 0 with empty results and the same cursor
- Rate limiting or X/Twitter API downtime may produce 5xx errors
- Query too broad may return truncated results with truncated: true

## How this service works

Monitor X/Twitter for changes - pass a search query and (optionally) a cursor from your last check, get back ONLY what's new since then, plus an AI change summary. Cursor-based so an agent never re-reads the same tweets. Brand monitoring, keyword alerts, competitor tracking. ?query=<advanced search>&since=<ISO timestamp or tweet id>. First call (no since) returns a baseline of the latest 20 + a cursor to pass next time.

## Output

Returns the count of new tweets since the last cursor, the tweets themselves (if any), a cursor (newest tweet ID) to pass on the next call so no tweets are re-read, a truncation flag, and an AI-generated change summary with sentiment (positive/neutral/negative).

## 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",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string"
      },
      "since": {
       "type": "string",
       "description": "ISO timestamp or numeric tweet id from a prior call's cursor; omit for a baseline"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cursor": {
   "newest_id": "1878000000000000000"
  },
  "new_count": 3,
  "truncated": false,
  "change_summary": {
   "summary": "...",
   "sentiment": "neutral"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-twitter-watch-cursor-based-change-monitor-0c82358e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clink-lithium-vault.fly.dev](https://www.zero.xyz/host/clink-lithium-vault.fly.dev/llms.txt)