Back to Browse
Otto AI Earnings Calendar
x402
Otto AI Earnings Calendar is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).
Returns upcoming and past earnings data for an equity or ETF ticker, including EPS estimates, report dates, session timing, and surprise results.
Price / call$0.003
Success—
StatusUnknown
How this service works
Earnings calendar and surprise history for a vendor-resolved equity: next report date/session with EPS and revenue estimates, latest reported EPS versus estimate, surprise percentage, and four-quarter history. Monetary estimates retain Finnhub payload units because the captured feed does not identify a currency. Event-window price drift is explicitly unavailable rather than inferred.
Output
Returns a JSON object with the ticker, data provider (Finnhub), last earnings details (result beat/miss, EPS surprise %, fiscal period end), next earnings details (report date, session timing like after-market-close, EPS estimate), and metadata including freshness timestamp and staleness in seconds.
Example use cases
Pre-earnings trade preparation
“Pull up NVDA's earnings calendar — I want to know when they're reporting next, whether it's before or after market close, and what the EPS estimate is so I can decide on a position.”
Post-earnings surprise analysis
“Did Tesla beat or miss earnings last quarter? I want to see the EPS surprise percentage and when the fiscal period ended.”
Earnings date monitoring for portfolio
“Check the earnings calendar for SPY — I need the next report date and the EPS estimate so I know when to expect volatility.”
Technical details
Endpoint
GEThttps://x402.ottoai.services/earnings-calendarWhen to prefer
Use this endpoint when you need structured earnings calendar data for a specific US equity or ETF ticker, including both historical EPS surprise results and upcoming report dates with session timing. Prefer this over generic financial data APIs when you need a single clean pay-per-call lookup without a subscription, especially within an AI agent workflow that already handles x402 micropayments on Base, Polygon, or Solana.
Side effects
- Unsupported ticker symbol returns an error or empty data payload
- ETFs with no earnings calendar (e.g. broad index ETFs) may return unavailable fields
- Pre/post price drift status may be returned as 'unavailable' when data is not available
- Stale data if cache has not refreshed — check meta.stalenessSec and meta.validUntil
- Missing or malformed ticker query parameter returns a validation error
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"data": {
"ticker": "AAPL",
"provider": "Finnhub",
"lastEarnings": {
"result": "beat",
"epsBasis": "vendor-reported",
"epsSurprisePct": 1.09
},
"nextEarnings": {
"session": "after-market-close",
"reportDate": "2026-07-30",
"epsEstimate": 1.93
},
"prePostPriceDrift": {
"status": "unavailable"
}
},
"meta": {
"degraded": false,
"validUntil": "",
"generatedAt": "",
"stalenessSec": 0
},
"status": "success"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"