{"uid":"cap_MUSMLz2AHG5hPi_nlrqoi","slug":"markettwits-news-sentiment-analysis-english-d046e8dd","name":"MarketTwits News Sentiment Analysis (English)","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/sentiment?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"],"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'."},"hours":{"type":"integer","default":24,"maximum":168,"minimum":1,"description":"Look-back window in hours (default 24, clamped to 1-168)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","hours","count","bullish","bearish","neutral","score","label","method"],"properties":{"note":{"type":"string"},"count":{"type":"integer"},"hours":{"type":"integer"},"label":{"enum":["bullish","bearish","neutral","no_data"],"type":"string"},"query":{"type":"string"},"score":{"type":"number","maximum":1,"minimum":-1,"description":"(bullish - bearish) / count"},"since":{"type":"string"},"method":{"enum":["heuristic"],"type":"string"},"bearish":{"type":"integer"},"bullish":{"type":"integer"},"neutral":{"type":"integer"},"examples":{"type":"object","properties":{"bearish":{"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"},"score":{"type":"number"},"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)"}}}},"bullish":{"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"},"score":{"type":"number"},"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)"}}}}}}}}}}}},"responseSchema":{"type":"json","example":{"note":"Heuristic keyword/emoji lexicon plus explicit '= ±X%' moves; not a language model.","count":6,"hours":24,"label":"bullish","query":"SpaceX","score":0.5,"since":"2026-10-20T16:00:00Z","method":"heuristic","bearish":1,"bullish":4,"neutral":1,"examples":{"bearish":[],"bullish":[{"id":389795,"score":1,"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"}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-LOuDjkdAQ5VqgQ3ZGsyb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs keyword-based sentiment analysis on recent MarketTwits Telegram posts (translated to English), returning bullish/bearish/neutral counts and a normalized score for a given query term.","exampleAgentPrompt":"What's the current sentiment on crude oil from MarketTwits over the last 48 hours — is the news running bullish or bearish?","exampleUseCases":[{"title":"Trading bot pre-trade sentiment check","prompt":"Before I place my crude oil trade, check the MarketTwits sentiment for 'oil' over the last 24 hours and tell me if it's running bullish or bearish with a score."},{"title":"Macro news mood monitoring for Fed policy","prompt":"What's the overall sentiment on MarketTwits about Fed rate hikes over the past 72 hours — are they leaning bullish or bearish, and how many posts mention it?"},{"title":"Crypto sentiment signal for Bitcoin","prompt":"Pull the sentiment score for Bitcoin from MarketTwits English news over the last 12 hours and show me a few example headlines from the bullish and bearish posts."}],"resultDescription":"Returns a JSON object with the query string, look-back window in hours, total matching post count, bullish/bearish/neutral counts, a normalized score between -1 (fully bearish) and +1 (fully bullish), an overall label (bullish/bearish/neutral/no_data), the window start time, the heuristic method used, and example headlines with post IDs, importance tags, source URLs, and publication timestamps.","failureModes":["No matching posts found for the query in the time window — returns label 'no_data' with count 0","Query string too short (< 1 char) or too long (> 100 chars) — validation error","Hours parameter out of range (< 1 or > 168) — clamped or rejected","Payment not processed (x402 payment required) — 402 response before data is returned","Service unavailable on Render cold start — delayed or timeout response"],"whenToPreferThis":"Choose this endpoint when you need a fast, real-time sentiment signal derived from one of Russia's top financial Telegram channels (MarketTwits), translated into English — especially for commodities, macro events, central bank news, and Russian market instruments. It uses a transparent heuristic lexicon (not an LLM), making it fast and deterministic. Prefer it over general news sentiment APIs when you specifically want Russian financial media perspective or when you need sentiment updated every few minutes with importance-tagged headlines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:34:02.580Z","isFirstParty":false,"canonicalSlug":"markettwits-news-sentiment-analysis-english-d046e8dd"}