# Clink Agent Twitter/X Ticker Pulse

> Clink Agent Twitter/X Ticker Pulse is a paid API for AI agents from clinkagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Returns X/Twitter social activity metrics for a US stock ticker over a chosen window, including post volume change, top posts, active accounts, and keyword topic flags.

## Facts

- Endpoint: GET https://clinkagent.com/x/ticker-pulse?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clink-agent-twitter-x-ticker-pulse-01de43c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rdWS4WIRAxEXjw83trxFA

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 clink-agent-twitter-x-ticker-pulse-01de43c3
```

Example prompt: Pull the 24-hour Twitter pulse for $TSLA — I want to see how post volume has changed vs the prior window, the top posts by likes, most active accounts, and any topic flags like earnings, SEC investigation, or short report.

## When to prefer this

Choose this endpoint when you need raw social activity facts (volume, top posts, active accounts, topic flags) for a specific US stock ticker on X/Twitter without needing a buy/sell signal or sentiment score. Ideal for trading agents that want to detect unusual social spikes or specific event-driven keyword flags (earnings, SEC, short report, M&A) before acting. Prefer over general Twitter search APIs when you need structured, normalized output purpose-built for stock tickers and agentic pipelines.

## Known failure modes

- Missing required ticker parameter returns an error
- Unsupported ticker symbol (non-US or invalid cashtag) may return empty results or error
- Invalid window value (not 24h or 7d) returns validation error
- Low-activity tickers may return minimal or zero post counts
- Payment failure or insufficient USDC balance blocks the request

## How this service works

X/Twitter activity for one US stock ticker, built for trading agents (Coinbase for Agents / x402 market data). Pass a $CASHTAG ticker, get post-volume vs the prior window, top posts by likes, most active accounts, and keyword topic flags (earnings, guidance, lawsuit, SEC investigation, recall, M&A, layoffs, upgrade/downgrade, short report, dividend, buyback, CEO). Facts and counts only, no buy/sell signal. ?ticker=TSLA or $TSLA&window=24h|7d (default 24h).

## Output

Returns a JSON object with the ticker symbol, time window, current post count, prior window post count, percentage change in post volume, top posts ranked by likes (with URLs), most active posting accounts, and a topic_flags object mapping keywords (earnings, guidance, lawsuit, SEC investigation, recall, M&A, layoffs, upgrade/downgrade, short report, dividend, buyback, CEO) to counts and example post URLs.

## 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": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string"
      },
      "window": {
       "enum": [
        "24h",
        "7d"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ticker": "TSLA",
  "window": "24h",
  "change_pct": 21.4,
  "post_count": 340,
  "topic_flags": {
   "earnings": {
    "count": 12,
    "example_url": "https://x.com/..."
   }
  },
  "post_count_prior": 280
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clink-agent-twitter-x-ticker-pulse-01de43c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clinkagent.com](https://www.zero.xyz/host/clinkagent.com/llms.txt)
