# MarketTwits Trending Topics (English)

> MarketTwits Trending Topics (English) is a paid API for AI agents from x402-markettwits-news.onrender.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-22).

Returns the top 5 trending financial topics from MarketTwits (Russian Telegram channel), ranked by recent mention frequency over a configurable time window, with English translations.

## Facts

- Endpoint: GET https://x402-markettwits-news.onrender.com/news/topics/trending?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/markettwits-trending-topics-english-585bf0ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_umY-FpbK9RJWkoNkpT3ZN

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-trending-topics-english-585bf0ba
```

Example prompt: What are the top trending topics on MarketTwits right now — show me what's been rising in the last 12 hours so I can see which macro themes or markets are heating up.

## When to prefer this

Choose this endpoint when you need real-time trending topic intelligence from Russian financial media (MarketTwits Telegram), translated into English, with momentum scoring (delta vs prior window). It is ideal for trading agents that need to detect emerging macro, geopolitical, oil, crypto, or equities narratives before they hit Western media. Prefer it over generic news APIs when you specifically want Russian financial market perspective or Telegram-sourced signals.

## Known failure modes

- No high-importance items in the requested window — fallback mode activates using the last 20 high items instead
- Hours parameter out of range (must be 1-72) — clamped or rejected
- Render.com cold start delay (service may spin up slowly if idle)
- Stale data if MarketTwits channel has low posting activity
- Payment failure via x402 protocol if USDC balance is insufficient

## 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 with up to 5 trending topics, each with: topic name (English), mention count in the current window, mention count in the prior equal-length window, net change (positive = rising), the ID and Telegram source URL of the latest item mentioning that topic, plus metadata including the hours window used, number of high-importance items analyzed, and a fallback flag (true when the window had no high-importance items and the last 20 were used instead).

## 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)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "hours",
      "items_considered",
      "fallback",
      "topics"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Explanation when fallback is true"
      },
      "hours": {
       "type": "integer",
       "description": "Window actually used (1-72)"
      },
      "topics": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "topic",
         "count",
         "prev_count",
         "change",
         "latest_id"
        ],
        "properties": {
         "count": {
          "type": "integer",
          "description": "Items mentioning the topic in the last N hours"
         },
         "topic": {
          "type": "string"
         },
         "change": {
          "type": "integer",
          "description": "count - prev_count (positive = rising)"
         },
         "latest_id": {
          "type": "integer",
          "description": "id of the newest item mentioning the topic"
         },
         "prev_count": {
          "type": "integer",
          "description": "Items mentioning it in the previous window of equal length"
         },
         "latest_source_url": {
          "type": "string",
          "description": "Source URL of that item"
         }
        }
       },
       "maxItems": 5
      },
      "fallback": {
       "type": "boolean",
       "description": "true when no high item fell in the window: the last 20 high items were used and compared with the 20 before them"
      },
      "items_considered": {
       "type": "integer",
       "descript
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hours": 6,
  "topics": [
   {
    "count": 6,
    "topic": "Iran",
    "change": 4,
    "latest_id": 389638,
    "prev_count": 2,
    "latest_source_url": "https://t.me/markettwits/389638"
   }
  ],
  "fallback": false,
  "items_considered": 12
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markettwits-trending-topics-english-585bf0ba/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)