# MarketTwits Telegram Channel Reader

> MarketTwits Telegram Channel Reader 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-23).

Fetches the latest posts from any public Telegram channel, with a primary focus on MarketTwits (top Russian financial news channel) translated into English

## Facts

- Endpoint: GET https://x402-markettwits-news.onrender.com/tg/channel/latest?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/markettwits-telegram-channel-reader-710efcb2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YmdY0jIZlhsHvQEwoCIGd

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-telegram-channel-reader-710efcb2
```

Example prompt: Pull the latest 20 posts from the MarketTwits Telegram channel and show me what they're saying about oil prices and central banks today.

## When to prefer this

Choose this endpoint when you need real-time English-language access to MarketTwits or other public Russian financial Telegram channels without building your own Telegram scraper. Ideal for trading bots, financial news agents, and macro monitoring pipelines that need Russian market commentary translated into English. Prefer this over general news APIs when specifically targeting Telegram channel content, especially for Russian financial market data, MOEX, CBR policy updates, or commodity/geopolitics coverage from the Russian financial media sphere.

## Known failure modes

- Channel does not exist or is private — returns error or empty result
- Channel username fails regex validation (must be 5-32 alphanumeric chars) — returns 400 bad request
- Upstream Telegram scraping fails — may return stale cached copy with stale:true flag
- Rate limiting or payment failure — x402 payment of $0.004 USDC required per call
- Limit parameter exceeds 50 — clamped or rejected
- Service temporarily unavailable on Render.com free-tier cold start

## 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

Returns a JSON object with a list of the most recent messages (newest first) from the specified public Telegram channel. Each item includes message ID, publication date, full text, direct Telegram link, view count, media types (photo/video/etc), whether it was edited, and the channel name. Also returns channel metadata: title, subscriber count, fetch timestamp, total page count, and a flag indicating whether the response is a stale cached copy.

## 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": [
      "channel"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1,
       "description": "Messages to return (default 20, max 50)"
      },
      "channel": {
       "type": "string",
       "pattern": "^@?[A-Za-z][A-Za-z0-9_]{3,31}$",
       "description": "Public Telegram channel username (5-32 chars; '@name' or a t.me link also accepted), e.g. markettwits"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "channel",
      "count",
      "items"
     ],
     "properties": {
      "via": {
       "enum": [
        "direct",
        "proxy"
       ],
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "items": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "channel",
         "date",
         "text",
         "link"
        ],
        "properties": {
         "id": {
          "type": "integer"
         },
         "date": {
          "type": [
           "string",
           "null"
          ]
         },
         "link": {
          "type": "string"
         },
         "text": {
          "type": "string"
         },
         "media": {
          "type": "array",
          "items": {
           "enum": [
            "photo",
            "video",
            "document",
            "poll"
           ],
           "type": "string"
          }
         },
         "views": {
          "type": [
           "integer",
           "null"
          ]
         },
         "edited": {
          "type": "boolean"
         },
         "channel": {
          "type": "string"
         },
         "views_raw": {
          "type": [
           "string",
           "null"
          ]
         },
         "forwarded_from": {
          "type": "str
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": 389929,
    "date": "2026-10-21T19:19:52+00:00",
    "link": "https://t.me/markettwits/389929",
    "text": "⚠️🇺🇸#META #spo #ии\nMeta ... — Semafor",
    "media": [],
    "views": 39000,
    "edited": true,
    "channel": "markettwits",
    "views_raw": "39K"
   }
  ],
  "pages": 1,
  "title": "MarketTwits",
  "cached": false,
  "source": "https://t.me/s/markettwits (public web preview)",
  "channel": "markettwits",
  "fetched_at": "2026-10-22T03:51:36Z",
  "subscribers": 339000,
  "subscribers_raw": "339K"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markettwits-telegram-channel-reader-710efcb2/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)