{"uid":"cap_3uQMrsxtvrjtWV9pl5lEl","slug":"alpha-vantage-earnings-via-locus-x402-b0500bf4","name":"Alpha Vantage Earnings via Locus x402","description":"Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.","url":"https://alphavantage.x402.paywithlocus.com/alphavantage/earnings","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"symbol":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q05mTgDGuE9-pLxC4xPr6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves earnings data (EPS, revenue, estimates, surprises) for a given stock ticker symbol via Alpha Vantage, paid per-call with USDC.","exampleAgentPrompt":"Can you pull the earnings history for NVDA — I want to see their quarterly EPS actuals versus estimates and any earnings surprises?","exampleUseCases":[{"title":"Earnings surprise screening for investors","prompt":"Get me the recent earnings data for Apple — I want to see whether they beat or missed EPS estimates last quarter and by how much."},{"title":"Fundamental analysis for stock research","prompt":"Pull the annual and quarterly earnings history for Microsoft so I can see their EPS trend over the last few years."},{"title":"Automated earnings alert for portfolio monitoring","prompt":"Check the latest earnings data for each of my holdings — TSLA, AMZN, and META — and tell me which ones beat expectations last quarter."}],"resultDescription":"Returns a JSON object containing historical earnings data for the specified stock ticker, including quarterly and annual EPS actuals, consensus estimates, surprise amounts, and surprise percentages as sourced from Alpha Vantage.","failureModes":["Invalid or unrecognized ticker symbol returns empty or error data","Private/delisted companies may have no earnings data available","Payment failure or insufficient USDC balance blocks the request","Rate limits on the underlying Alpha Vantage API may cause timeouts or empty responses","Very small-cap or OTC stocks may have incomplete earnings records"],"whenToPreferThis":"Choose this endpoint when you need structured earnings data — EPS actuals, estimates, surprises, and history — for publicly traded US equities, especially in a pay-per-call context without needing a full Alpha Vantage subscription. Prefer it over general market data endpoints when the specific need is fundamental earnings analysis rather than real-time price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:15.253Z","isFirstParty":false}