# MarketTwits News by Country (English, x402)

> MarketTwits News by Country (English, x402) 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).

Returns recent English-translated MarketTwits financial news items filtered by country, with importance tagging, top topics, and post counts over a configurable time window.

## Facts

- Endpoint: GET https://x402-markettwits-news.onrender.com/news/country?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-news-by-country-english-x402-f656c2ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EL1iJIzLp-wSZzPBHnsRz

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-by-country-english-x402-f656c2ad
```

Example prompt: Pull the last 48 hours of high-importance MarketTwits news about China — I need the translated headlines with links to the original Telegram posts.

## When to prefer this

Choose this endpoint when you need real-time, English-translated financial news from MarketTwits (a leading Russian-language financial Telegram channel) filtered specifically by country, with importance classification and topic aggregation baked in. It is ideal for trading bots, news agents, or geopolitical monitors that need structured, filtered access to Russian financial media in English without building a translation or scraping pipeline. Prefer alternatives if you need non-MarketTwits sources, other languages, or news beyond a 7-day window.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Very small or obscure countries may return zero matching posts
- Truncation: only up to 10 latest items returned regardless of total count
- Hours parameter outside 1–168 range is clamped or rejected
- Payment failure (402) if USDC payment is not processed correctly
- Temporary unavailability of the Render-hosted service causing timeouts

## 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 the queried country code, emoji flag, total post count, high-importance count, the look-back window in hours, a start timestamp, importance filter used, up to 10 most recent headlines (each with Telegram post ID, translated headline, importance level, source URL, and publication time), top topics with counts, number of flag-matched posts, and share-of-window percentage.

## 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": [
      "code"
     ],
     "properties": {
      "code": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "ISO 3166-1 alpha-2 country code (e.g. US, RU, CN, UA, IR, GB; UK = GB; EU accepted)"
      },
      "hours": {
       "type": "integer",
       "default": 24,
       "maximum": 168,
       "minimum": 1,
       "description": "Look-back window in hours (default 24, clamped to 1-168)"
      },
      "importance": {
       "enum": [
        "all",
        "high",
        "medium",
        "low"
       ],
       "type": "string",
       "default": "all",
       "description": "Importance filter (default all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "code",
      "hours",
      "count",
      "high_count",
      "latest",
      "top_topics"
     ],
     "properties": {
      "code": {
       "type": "string"
      },
      "flag": {
       "type": [
        "string",
        "null"
       ]
      },
      "count": {
       "type": "integer"
      },
      "hours": {
       "type": "integer"
      },
      "since": {
       "type": "string"
      },
      "latest": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "published_at",
         "importance",
         "headline",
         "source_url"
        ],
        "properties": {
         "id": {
          "type": "integer",
          "examples": [
           389638
          ],
          "description": "Telegram post id in t.me/markettwits"
         },
         "headline": {
          "type": "string",
          "description": "First meaningful line, emoji removed"
         },
         "importance": {
          "enum": [
           "high",
           "medium",
           "low"
          ],
          "type": "string"
         },
         "source_url": {
          "t
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": "RU",
  "flag": "🇷🇺",
  "count": 112,
  "hours": 24,
  "since": "2026-10-20T16:00:00Z",
  "latest": [
   {
    "id": 389795,
    "headline": "SPCX = +9%: SpaceX posted a quarterly profit for the first time",
    "importance": "high",
    "source_url": "https://t.me/markettwits/389795",
    "published_at": "2026-10-21T10:02:00Z"
   }
  ],
  "by_flag": 93,
  "high_count": 31,
  "importance": "all",
  "top_topics": [
   {
    "count": 40,
    "topic": "Russia"
   }
  ],
  "share_of_window": 49.1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markettwits-news-by-country-english-x402-f656c2ad/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)