{"uid":"cap_ckzDcd8LtwWh_4FaIZsYF","slug":"twelvex-earnings-calendar-ada05457","name":"TwelveX Earnings Calendar","description":"Premium financial data API — 25 endpoints for stocks, forex, crypto, and technical analysis. Powered by Twelve Data.","url":"https://tw3lvtrexdata.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":"unknown","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_-gQBYt_8vOIQ_ezIyyIiC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns scheduled corporate earnings announcements for stocks within a specified date range","exampleAgentPrompt":"Pull the earnings calendar from TwelveX for the next two weeks — from July 14 to July 28 — so I can see which companies are reporting their quarterly results.","exampleUseCases":[{"title":"Earnings calendar for options trading","prompt":"I'm planning some options plays around earnings season — can you pull the full earnings calendar from TwelveX for the next 30 days so I can spot which companies are reporting and time my trades accordingly?"},{"title":"Q4 tech earnings research sweep","prompt":"I want to do a deep dive on tech sector earnings — use TwelveX to pull all scheduled earnings announcements from October through December so I can see when the major players are releasing their Q4 results."},{"title":"Weekly earnings briefing for portfolio","prompt":"Before the week kicks off, grab this week's earnings calendar from TwelveX so I can see which companies in my watchlist are reporting and flag any that might move the market."}],"resultDescription":"A structured list of corporate earnings events scheduled within the requested date range, including company names, ticker symbols, expected EPS, and reporting dates, returned as a JSON object powered by Twelve Data.","failureModes":["Invalid date format returns an error — dates must be in YYYY-MM-DD format","Empty result if no earnings are scheduled in the requested range","Overly wide date range may return very large payloads or be rejected","Payment failure (402) if USDC balance is insufficient","Service unavailable if Twelve Data upstream is down"],"whenToPreferThis":"Use this endpoint when you need a calendar view of upcoming or past corporate earnings announcements across all stocks, particularly when planning trades or research around earnings season. Prefer this over individual stock lookups when you need a broad date-range sweep of all reporting companies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:38:47.890Z","isFirstParty":false}