{"uid":"cap_EL1iJIzLp-wSZzPBHnsRz","slug":"markettwits-news-by-country-english-x402-f656c2ad","name":"MarketTwits News by Country (English, x402)","description":"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.","url":"https://x402-markettwits-news.onrender.com/news/country?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":"string","description":"Original Russian post"},"published_at":{"type":"string","description":"Publication time of the original post (ISO 8601)"}}},"description":"Up to 10, newest first"},"by_flag":{"type":"integer","description":"Matches by flag emoji (the rest by country keywords)"},"high_count":{"type":"integer"},"importance":{"type":"string"},"top_topics":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"topic":{"type":"string"}}}},"share_of_window":{"type":"number","description":"Percent of all items in the window"}}}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_x5os45LEkMgo5sbl5ohxM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent English-translated MarketTwits financial news items filtered by country, with importance tagging, top topics, and post counts over a configurable time window.","exampleAgentPrompt":"Pull the last 48 hours of high-importance MarketTwits news about China — I need the translated headlines with links to the original Telegram posts.","exampleUseCases":[{"title":"Trading bot macro monitoring","prompt":"Give me all high-importance MarketTwits financial news about the US from the past 6 hours so my trading bot can react to macro events."},{"title":"Geopolitical risk briefing","prompt":"What are the top MarketTwits stories about Iran over the last 72 hours? Show me both high and medium importance items with their publication times."},{"title":"Central bank news digest","prompt":"Fetch today's MarketTwits news about the EU — I want everything from the last 24 hours ranked by importance so I can track ECB and macro developments."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:37:28.444Z","isFirstParty":false,"canonicalSlug":"markettwits-news-by-country-english-x402-f656c2ad"}