{"uid":"cap_Gf4UVYcIg2l1KsiRIbzS4","slug":"twelvex-earnings-calendar-625ed22e","name":"TwelveX Earnings Calendar","description":"Premium financial data API — 25 endpoints for stocks, forex, crypto, and technical analysis. Powered by Twelve Data.","url":"https://twelv1x402.vercel.app/api/earnings-calendar","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"end_date":{"type":"string"},"start_date":{"type":"string"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EpF99zung0Pac9jqWNfTv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a calendar of upcoming and historical corporate earnings announcements filtered by date range","exampleAgentPrompt":"Pull the earnings calendar from Twelve Data for next week — from Monday May 19 to Friday May 23 — so I can see which companies are reporting.","exampleUseCases":null,"resultDescription":"A structured list of earnings events within the specified date range, including company names, ticker symbols, scheduled earnings dates, expected EPS estimates, actual EPS values (for past events), revenue estimates, and fiscal quarter details.","failureModes":["Invalid date format returns an error — dates must be in YYYY-MM-DD format","Date range too broad may return empty or truncated results","Missing start_date or end_date may return a validation error or default to a narrow window","Upstream Twelve Data API outage results in a 502 or 503 response","Payment of 0.15 USDC not received triggers a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a date-bounded list of corporate earnings announcements including EPS estimates and actuals. Prefer this over manual web scraping or free tier APIs when you need reliable, structured earnings data with broad market coverage spanning stocks, forex context, and crypto-adjacent equities, and are willing to pay per-call pricing for accuracy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:53.498Z","isFirstParty":false}