{"uid":"cap_s2fFP7VKpWpq9e1b0X5gV","slug":"markettwits-data-surprises-feed-a6641bfe","name":"MarketTwits Data Surprises Feed","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/data-surprises?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":[],"properties":{"q":{"type":"string","maxLength":100,"minLength":1,"description":"Optional keyword filter (same matching as /news/search)"},"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":["hours","count","above","below","items"],"properties":{"above":{"type":"integer"},"below":{"type":"integer"},"count":{"type":"integer"},"hours":{"type":"integer"},"items":{"type":"array","items":{"type":"object","required":["kind","indicator","actual","expected","surprise","direction","id"],"properties":{"id":{"type":"integer"},"kind":{"enum":["macro","earnings"],"type":"string"},"unit":{"type":["string","null"],"description":"%, M, B, K, $, '% m/m' ..."},"actual":{"type":"number"},"ticker":{"type":"string"},"expected":{"type":"number"},"previous":{"type":["number","null"]},"surprise":{"type":"number","description":"actual - expected (same unit)"},"direction":{"enum":["above","below","inline"],"type":"string"},"indicator":{"type":"string"},"importance":{"type":"string"},"source_url":{"type":"string"},"published_at":{"type":"string"},"surprise_pct":{"type":["number","null"],"description":"surprise / |expected| * 100"}}},"description":"Newest first, max 50"},"query":{"type":["string","null"]},"since":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"above":1,"below":0,"count":1,"hours":24,"items":[{"id":389757,"kind":"macro","unit":"%","actual":3.5,"expected":3.4,"previous":3.1,"surprise":0.1,"direction":"above","indicator":"UK - CONSUMER PRICE INFLATION CPI (Sep) — y/y","importance":"high","source_url":"https://t.me/markettwits/389757","published_at":"2026-10-21T06:00:00Z","surprise_pct":2.9}],"query":null,"since":"2026-10-20T16:00:00Z"}},"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_OVVNnYjDNhg1R5WwM2aAf","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":"Returns macro and earnings data-surprise events (actual vs. expected, with surprise magnitude and direction) from MarketTwits, filtered by a look-back window and optional keyword","exampleAgentPrompt":"Show me all macro and earnings data surprises from the last 48 hours where the actual came in above expectations — include the surprise size and importance level for each.","exampleUseCases":[{"title":"Pre-market surprise briefing for traders","prompt":"Give me a summary of all economic data surprises from the last 12 hours, sorted by how much they beat or missed expectations, so I can prepare for the trading session."},{"title":"CPI and inflation surprise alert","prompt":"Check the last 24 hours for any data surprises related to CPI or inflation and tell me whether they came in above or below expectations and by how much."},{"title":"Automated trading bot data feed","prompt":"Fetch all macro data surprises from the past 6 hours — I need the indicator name, actual vs expected values, the surprise percentage, and direction for each one so my bot can react to them."}],"resultDescription":"A JSON object containing the count of events, number above/below expectations, the look-back window, and an array of up to 50 data-surprise items (newest first). Each item includes the indicator name, kind (macro or earnings), actual/expected/previous values, surprise delta and percentage, direction (above/below/inline), importance level, publication timestamp, and a source URL pointing to the original Telegram post.","failureModes":["Invalid hours value outside 1–168 range returns a validation error","Keyword filter q returns empty items array if no matching surprises exist in the window","Endpoint may be temporarily unavailable if the underlying Render.com host is cold-starting","Payment of 0.006 USDC required per call — missing or invalid x402 payment header returns 402","No data available if MarketTwits channel has not posted in the requested window"],"whenToPreferThis":"Choose this endpoint when you need structured economic data-surprise events (actual vs. expected with magnitude) sourced from MarketTwits in real time, especially if you want macro and earnings surprises in a single filterable feed. It is particularly valuable for trading bots, news agents, or dashboards that need to react quickly to beats/misses on economic releases with importance tagging already applied.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:42:30.974Z","isFirstParty":false,"canonicalSlug":"markettwits-data-surprises-feed-a6641bfe"}