{"uid":"cap_45BY1MzR_K3uDE44_Y2VD","slug":"market2000-xyz-earnings-surprise-1fd15ffd","name":"market2000.xyz Earnings Surprise","description":"Earnings Surprise — beat/miss history, price reaction, consistency signals.\n\nHOW TO CALL:\n  GET /api/earnings-surprise?ticker=NVDA&periods=8\n\nPARAMETERS:\n  ticker  — stock ticker (required)\n  periods — quarters to analyze, 4–20 (default 8)\n\nRESPONSE: beat_rate, avg surprise, per-quarter reactions, signals{consistent_beater,…}.\n\nPRICING: $0.02 per call.","url":"https://market2000.xyz/api/earnings-surprise","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"Stock ticker (NVDA, TSLA, LLY)"},"periods":{"type":"integer","default":8,"description":"Quarters to analyze (4–20)"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d3VHZ5cioRjDMWtw2ueVE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns earnings beat/miss history, average surprise magnitude, per-quarter price reactions, and consistency signals for a given stock ticker over a configurable number of quarters.","exampleAgentPrompt":"Pull the earnings surprise history for NVDA over the last 8 quarters — I want to see the beat rate, average surprise, and whether it's flagged as a consistent beater.","exampleUseCases":[{"title":"Pre-earnings trade setup check","prompt":"Before NVIDIA reports next week, can you pull its earnings surprise history for the last 12 quarters? I want to know the beat rate, how big the average surprise has been, and what the typical price reaction looks like after a beat."},{"title":"Consistent beater screening","prompt":"I'm building a list of stocks with strong earnings consistency — can you check the earnings surprise data for TSLA over the last 8 quarters and tell me if it shows up as a consistent beater?"},{"title":"Biotech earnings volatility research","prompt":"Look up LLY's earnings surprise record for the past 16 quarters — I need the per-quarter price reactions and the average surprise size to understand how volatile its earnings moves tend to be."}],"resultDescription":"Returns a structured response including: overall beat rate (fraction of quarters where actual earnings exceeded estimates), average earnings surprise percentage, a per-quarter breakdown of surprise magnitude and subsequent price reaction, and derived signals such as whether the ticker qualifies as a 'consistent_beater' or shows other behavioral patterns across the analyzed period.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Periods parameter outside 4–20 range may be rejected or clamped","Insufficient historical data for lesser-known or newly listed stocks","Payment failure (x402) if USDC balance is insufficient","Rate limiting or timeout on high-frequency calls"],"whenToPreferThis":"Use this endpoint when you need a quick, structured summary of a stock's earnings surprise track record — beat rate, magnitude, and price reaction — without building your own earnings database. It is especially useful pre-earnings as a signal-quality check, or when screening for consistent earnings beaters. Prefer this over general financial data APIs when you specifically need the consistency signals and aggregated surprise metrics rather than raw earnings figures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:35:26.930Z","isFirstParty":false}