{"uid":"cap_rSGv3Uj_Xn_8CI-AViZJB","slug":"markettwits-telegram-channel-search-4a9bd6d3","name":"MarketTwits Telegram Channel Search","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/tg/search?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":["q","channels"],"properties":{"q":{"type":"string","maxLength":100,"minLength":1,"description":"Keywords (case-insensitive). Several words = all must match. Hashtags match with or without '#', e.g. 'oil', '#Fed rates'."},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"Messages to return (default 20, max 50)"},"channels":{"type":"string","description":"1-5 comma-separated public channel usernames, e.g. markettwits,rbc_news"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","channels","count","items","per_channel"],"properties":{"via":{"enum":["direct","proxy"],"type":"string"},"note":{"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":"string"}}},"description":"Merged, newest first"},"query":{"type":"string"},"stale":{"type":"boolean","description":"true when the upstream failed and a recent cached copy was served"},"cached":{"type":"boolean"},"source":{"type":"string"},"channels":{"type":"array","items":{"type":"string"}},"fetched_at":{"type":"string"},"per_channel":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"error":{"type":"string"},"title":{"type":["string","null"]},"detail":{"type":"string"},"channel":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":389883,"date":"2026-10-21T14:30:11+00:00","link":"https://t.me/markettwits/389883","text":"#нефть ...","media":[],"views":41000,"edited":false,"channel":"markettwits","views_raw":"41K"}],"query":"нефть","source":"https://t.me/s/<channel>?q= (public web preview)","channels":["markettwits","rbc_news"],"fetched_at":"2026-10-22T03:51:36Z","per_channel":[{"count":20,"title":"MarketTwits","channel":"markettwits"},{"count":20,"title":"РБК. Новости. Главное","channel":"rbc_news"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ifFKv21Ra9l60iDzei4b3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches public Telegram channels (including MarketTwits) for messages matching keywords, returning posts with metadata like date, views, and media","exampleAgentPrompt":"Search MarketTwits and rbc_news on Telegram for the 20 most recent posts mentioning 'oil Fed' and show me the text, date, and link for each one.","exampleUseCases":[{"title":"Trading bot oil price monitoring","prompt":"Search the MarketTwits Telegram channel for the latest 30 messages mentioning 'oil' or '#нефть' and give me the text and timestamps so I can track crude price signals."},{"title":"Macro news scan for hedge fund","prompt":"Look up the 20 most recent posts in MarketTwits and rbc_news that mention 'Fed rates' and return the full message text, view counts, and links."},{"title":"Geopolitics alert for news agent","prompt":"Search MarketTwits on Telegram for posts about 'sanctions geopolitics' and return up to 50 results with dates and links so I can flag high-impact items."}],"resultDescription":"A JSON object containing a merged list of matching Telegram messages (newest first), each with message ID, channel name, date, full text, link, view count, media types, and edit status. Also includes per-channel breakdown, total count, fetch timestamp, and a stale flag indicating if cached data was served due to upstream failure.","failureModes":["Invalid or private channel username returns an error in per_channel array","No messages found for given keywords returns count:0 with empty items array","Upstream Telegram scraping failure returns stale cached data with stale:true flag","Query string too long (over 100 characters) rejected with validation error","More than 5 channels specified results in rejection","limit exceeding 50 returns validation error"],"whenToPreferThis":"Use this endpoint when you need to search specific public Telegram channels — especially MarketTwits and Russian financial news channels — for keyword-matching messages. Prefer it over generic news APIs when the target audience requires Russian financial market signals, real-time Telegram content, or when you need to search by hashtags common in Russian finance (e.g. #нефть, #Fed). Best suited for trading bots, news aggregators, and financial research agents that need direct Telegram post retrieval with view counts and timestamps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:36:42.525Z","isFirstParty":false,"canonicalSlug":"markettwits-telegram-channel-search-4a9bd6d3"}