# MarketTwits News — Market Movers (English)

> MarketTwits News — Market Movers (English) is a paid API for AI agents from x402-markettwits-news.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

Returns top gaining and losing tickers mentioned in MarketTwits (Russia's top financial Telegram channel) over a configurable look-back window, with percentage moves, headlines, and importance tags.

## Facts

- Endpoint: GET https://x402-markettwits-news.onrender.com/news/movers?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/markettwits-news-market-movers-english-45d5af1d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tbs8GnveJrPsz09UMMt7U

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 markettwits-news-market-movers-english-45d5af1d
```

Example prompt: Pull the top market movers from MarketTwits for the last 12 hours and show me any tickers that moved more than 3%.

## When to prefer this

Choose this endpoint when you need a pre-ranked, structured list of market-moving tickers sourced specifically from MarketTwits — Russia's leading financial Telegram channel — with move percentages and importance filtering already applied. It is superior to raw news feeds when you want equity movers with quantified percentage moves rather than unstructured headlines. Prefer it over generic news APIs when Russian market perspective, MOEX-listed tickers, or geopolitically-driven moves are relevant. Best for trading bots, alert systems, and daily market briefings that need fast, ranked signal extraction from a curated Russian financial source.

## Known failure modes

- No movers found if min_pct is set too high for the chosen time window — returns empty gainers/losers arrays
- Invalid min_pct format (non-numeric string) may return a 400 error
- hours parameter outside 1-72 range is clamped, not errored — results may differ from expectation
- Payment failure (402) if USDC not provided or insufficient — endpoint requires $0.005 USDC per call
- Stale data risk if MarketTwits channel has low activity in the look-back window
- Service availability issues on Render.com free tier (cold starts or downtime)

## How this service works

Real-time English translations of MarketTwits (top Russian financial Telegram channel). Covers macro, central banks, oil/commodities, geopolitics, equities and crypto. Items are tagged high/medium importance and updated every few minutes. Ideal for trading bots and news agents. Also sells Russian market data (CBR FX and key rate, MOEX quotes/indices/movers, Rosstat fuel prices), public Telegram channel reading/search and Wildberries/Ozon product data.

## Output

A JSON object containing two ranked lists — 'gainers' (up to 10 tickers, largest move first) and 'losers' (up to 10 tickers, most negative first) — each item including ticker symbol, signed percentage move, company name, country ISO code, headline text from the MarketTwits post, importance rating (high/medium), source Telegram URL, and published timestamp. Also returns the look-back window parameters used.

## 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": [],
     "properties": {
      "hours": {
       "type": "integer",
       "default": 6,
       "maximum": 72,
       "minimum": 1,
       "description": "Look-back window in hours (default 6, clamped to 1-72)"
      },
      "min_pct": {
       "type": "string",
       "default": "0",
       "pattern": "^[0-9]+([.,][0-9]+)?$",
       "description": "Minimum absolute move in percent (default 0, max 100), e.g. 3 or 2.5"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "hours",
      "min_pct",
      "since",
      "tickers_found",
      "gainers",
      "losers"
     ],
     "properties": {
      "hours": {
       "type": "integer"
      },
      "since": {
       "type": "string"
      },
      "losers": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "ticker",
         "pct",
         "id",
         "published_at"
        ],
        "properties": {
         "id": {
          "type": "integer"
         },
         "pct": {
          "type": "number",
          "description": "Reported move in percent (signed)"
         },
         "name": {
          "type": [
           "string",
           "null"
          ]
         },
         "ticker": {
          "type": "string"
         },
         "country": {
          "type": [
           "string",
           "null"
          ],
          "description": "ISO code from the flag before the ticker"
         },
         "headline": {
          "type": "string"
         },
         "importance": {
          "type": "string"
         },
         "source_url": {
          "type": "string"
         },
         "published_at": {
          "type": "string"
         }
        }
       },
       "description": "Top 10, most negative first"
      },
      "gainers": {
       "type": "array",
       "items": {
        "type": "object",
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hours": 6,
  "since": "2026-10-21T10:00:00Z",
  "losers": [
   {
    "id": 389768,
    "pct": -6,
    "name": "Netflix",
    "ticker": "NFLX",
    "country": "US",
    "headline": "After-hours moves following earnings: SPCX SpaceX = +8%",
    "importance": "medium",
    "source_url": "https://t.me/markettwits/389768",
    "published_at": "2026-10-21T06:10:00Z"
   }
  ],
  "gainers": [
   {
    "id": 389858,
    "pct": 16,
    "name": null,
    "ticker": "KLVZ",
    "country": "RU",
    "headline": "KLVZ = +16%: PUTIN AND WITKOFF HAD A SUBSTANTIVE CONVERSATION - PESKOV",
    "importance": "high",
    "source_url": "https://t.me/markettwits/389858",
    "published_at": "2026-10-21T15:40:00Z"
   }
  ],
  "min_pct": 2,
  "tickers_found": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markettwits-news-market-movers-english-45d5af1d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-markettwits-news.onrender.com](https://www.zero.xyz/host/x402-markettwits-news.onrender.com/llms.txt)
