# EarningsNxt

> AI-assisted earnings briefs, calendar, and analysis delivered to your inbox before each report.

EarningsNxt provides structured, machine-readable earnings intelligence. Pre-earnings briefs tell you what to expect. Post-earnings briefs tell you what happened. All data is optimized for AI agent consumption.

## API Access

Base URL: https://earningsnxt.ai/api/v1

### Free Tier (no auth required)
- Earnings briefs for top 100 tickers (AAPL, MSFT, NVDA, AMZN, GOOGL, META, etc.)
- Full earnings calendar for all tickers
- Ticker directory with search
- 60 requests/minute

### Pro Tier ($8/month — Bearer token auth)
- Earnings briefs for ALL tracked tickers
- Email alerts, weekly digests, historical data
- 300 requests/minute
- Sign up: https://earningsnxt.ai/signup

## Endpoints

### GET /api/v1/briefs/{symbol}/{quarter}
Returns AI-assisted pre/post earnings brief with analyst estimates, options data, and results.
- Example: https://earningsnxt.ai/api/v1/briefs/AAPL/Q1-2026
- Free for top 100 tickers, Pro API key for others.
- Response includes: company info, estimates, results, pre-brief, post-brief.
- Markdown variant: append `?format=md` or send `Accept: text/markdown` to receive the same brief as plain Markdown — ideal for direct ingestion by LLMs.

### GET /ticker/{symbol}/earnings/{quarter}.md
Plain-Markdown rendering of the earnings brief at the same canonical URL as the human-facing page. Same paywall and rate-limit rules as /api/v1/briefs.
- Example: https://earningsnxt.ai/ticker/AAPL/earnings/Q1-2026.md
- Designed for AI agents and crawlers (Perplexity, ChatGPT browsing, Claude with web access) that ingest Markdown more reliably than rendered HTML.

### GET /api/v1/calendar?from=YYYY-MM-DD&to=YYYY-MM-DD&limit=100
Returns upcoming earnings events with estimates and implied moves.
- Default: next 30 days, up to 100 events.
- Free, no auth required.

### GET /api/v1/tickers?q=search&sector=Technology&free=true
Lists available tickers with sector, market cap, and free/pro tier info.
- Free, no auth required.

### GET /api/v1/pricing
Machine-readable pricing, plan details, and full API documentation.
- Free, no auth required.

## Authentication
Pro endpoints require a Bearer token:
```
Authorization: Bearer YOUR_API_KEY
```

## Brief Structure

### Pre-Earnings Brief
- companySnapshot: What the company does (2-4 sentences)
- keyMetrics: 3-5 key metrics with consensus values
- lastQuarterRecap: Summary + management promises
- wallStreetExpectations: Bull case, bear case, summary
- optionsSignal: Implied move % and context
- earningsTrackRecord: Historical quarters with EPS surprise and stock reaction
- whatToListenFor: 4-5 actionable items to watch

### Post-Earnings Brief
- headline: One-line summary of results
- keyNumbers: Actual vs expected for 3-6 metrics
- managementCommentary: Tone, quotes, summary
- guidanceChanges: Forward guidance updates
- whatItMeans: 3-5 sentences on implications

## Content Policy
- Briefs are AI-assisted analysis, not financial advice.
- Data refreshes hourly. Calendar updates daily.
- Attribution appreciated: "Source: EarningsNxt (https://earningsnxt.ai)"