oanor
Sign up free
Marketplace Pricing Features Sign in

API · /earningssurprise-api

Earnings Surprise (Beat/Miss) API

healthy 4,615 Subscribers

Live earnings beat/miss track record for US stocks from Nasdaq — no key, nothing stored. The "does it beat the street" view of a stock: how its actual reported EPS has compared to the analyst consensus over the recent quarters, distinct from the earnings-calendar (upcoming dates), analyst (forward estimates) and financials APIs in the catalogue. The surprises endpoint returns the recent quarters with the actual EPS, the consensus forecast, the dollar and percent surprise, and whether the quarter was a beat, a miss or in line. The scorecard endpoint computes the track record — how many of the recent quarters beat, the beat rate, the average surprise, the latest result and the current beat/miss streak — so you can gauge how reliably a company tops expectations. Build earnings-quality screeners, beat-streak scanners, post-earnings-drift signals and event-driven trading tools on top of real Nasdaq earnings-surprise data. The surprise is the actual reported EPS versus the analyst consensus for the quarter; a positive percent surprise is a beat. Look up any US stock by its ticker.

#trading #earnings #surprise #eps #stocks #beat-miss #equities #finance
api.oanor.com/earningssurprise-api
Get an API key Try in playground → Contact provider

Machine-readable spec so AI agents can integrate this API.

/api/earningssurprise-api/openapi.json
/api/earningssurprise-api/llms.txt

Discovery: GET /api/index.json lists every API.

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
117 ms
Server probes · 24h
Subscribers
4,615
active
Total calls
0
last 7 days
status Full status page → · 3 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

Free

  • 11,600 calls / month
  • 3 requests / second
  • Hard cap (429 above quota, no overage)
  • 11.6k calls/month
  • 3 req/sec
  • All endpoints
  • No credit card
Sign in to subscribe

Starter

€7.95 /month

  • 182,000 calls / month
  • 10 requests / second
  • Hard cap (429 above quota, no overage)
  • 182k calls/month
  • 10 req/sec
  • Email support
Sign in to subscribe

Pro

€24.10 /month

  • 772,000 calls / month
  • 28 requests / second
  • Hard cap (429 above quota, no overage)
  • 772k calls/month
  • 28 req/sec
  • Priority support
Sign in to subscribe

Scale

€54.80 /month

  • 2,760,000 calls / month
  • 60 requests / second
  • Hard cap (429 above quota, no overage)
  • 2.76M calls/month
  • 60 req/sec
  • Dedicated SLA
Sign in to subscribe

Built by

P
PremiumApi

Related APIs

Other APIs with overlapping tags.

Kalshi Event Markets API

Live market data from Kalshi, the CFTC-regulated US event-contract exchange, served from its public trade API. Kalshi lists yes/no contracts that settle on real-world outcomes — elections, economics, Federal Reserve decisions, weather, sports and world events — and the executed price is the market-implied probability of that outcome. The trades endpoint returns the recent public trade tape: the executed price (as cents and as a 0-1 probability), the size, the taker side and the time — the live pulse of what is actually trading. The events endpoint lists the events (the questions) that group markets, with their category and series. The markets endpoint is the contract directory — every tradable market with its ticker, the yes outcome it settles on, its status and open/close times — filterable by event, series or status. This is a regulated real-money event-contract venue — live implied probabilities and order flow — distinct from the play-money (Manifold), political (PredictIt) and crypto (Polymarket) prediction-market APIs in the catalogue. Live order-book snapshots are gated behind authentication upstream, so prices are sourced from the public trade tape. Live, no key on the upstream, nothing stored.

api.oanor.com/kalshi-api

Put/Call Ratio & Options Sentiment API

Live (15-minute delayed) options put/call sentiment analytics for US stocks and indices, computed from CBOE's public delayed-quotes feed. The ratio endpoint aggregates the entire option chain into the headline sentiment gauges — the put/call ratio by volume and by open interest, the total put and call volume and open interest, the contract counts, and the underlying price with its 30-day implied volatility (IV30) — plus a plain-language sentiment lean. The expiries endpoint breaks the put/call ratio down by expiration date, giving the term structure of sentiment. The strikes endpoint maps call-versus-put volume and open interest across strikes for an expiration, showing where positioning sits. This is the computed options-sentiment and positioning view — ratios and skew, not a contract dump — distinct from the raw options-chain, the volatility-index and the options-pricing calculators in the catalogue. US index options use an underscore-prefixed symbol (_SPX, _VIX); a ratio above 1 means more puts than calls (defensive/bearish lean). Live, no key on the upstream, nothing stored.

api.oanor.com/putcallratio-api

Intraday Stock Candles API

Live intraday and historical OHLCV candles for stocks, indices, ETFs, crypto and FX, served from Yahoo Finance's public chart feed. The candles endpoint returns regular-session bars — open, high, low, close and volume — at a chosen interval (1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 1wk, 1mo) over a range, each bar timestamped. The extended endpoint returns the pre-market and after-hours (extended-hours) bars, each labelled with its session. The latest endpoint returns an intraday snapshot — current price, day change and percent, the day open/high/low and volume, the 52-week range and the most recent bar. Symbols follow Yahoo conventions: US tickers (AAPL, MSFT), indices (^GSPC, ^IXIC), crypto (BTC-USD) and FX (EURUSD=X). This is the intraday candlestick / OHLCV view — per-minute to hourly bars plus extended hours — distinct from the daily price-history, the live-quote and the FX/rate APIs in the catalogue. Live, no key on the upstream, nothing stored.

api.oanor.com/intraday-api

Stock Options Chain API

Live (15-minute delayed) US equity and index options chains, served from CBOE's public delayed-quotes feed. For any optionable ticker the summary endpoint returns the underlying quote — current price, day change, open/high/low/close, volume, bid/ask and the 30-day implied volatility (IV30) with its change. The expirations endpoint lists every available expiration date with its call and put contract counts. The chain endpoint returns the option contracts themselves: for each strike and expiry it gives the call/put bid, ask, last, implied volatility, open interest, volume and the full greeks — delta, gamma, theta and vega — and can be filtered by expiration date and by call or put. US index options are addressed with an underscore prefix (_SPX, _VIX). This is the single-name equity and index options surface — strikes, expiries, IV and greeks — distinct from the options-pricing calculators, the crypto-options and the FX/rate APIs in the catalogue. Live, no key on the upstream, nothing stored.

api.oanor.com/optionschain-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for Earnings Surprise (Beat/Miss) API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call Earnings Surprise (Beat/Miss) API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for Earnings Surprise (Beat/Miss) API?
Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.
How much does Earnings Surprise (Beat/Miss) API cost?
Earnings Surprise (Beat/Miss) API has a free tier with 100 calls / month. Paid plans start at €7.95 / month with higher quotas and faster rate limits.
Can I cancel my subscription anytime?
Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.
Is Earnings Surprise (Beat/Miss) API GDPR-compliant?
All requests to Earnings Surprise (Beat/Miss) API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.

Pick an endpoint from the list on the left to see its details and try it.

Code snippets

Sign up to get an API key, then call any path under your slug.

curl https://api.oanor.com/earningssurprise-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/earningssurprise-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/earningssurprise-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);
import requests
r = requests.get(
    "https://api.oanor.com/earningssurprise-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

Sign in to rate.

No reviews yet.

Discussion

Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.

Sign in to start a thread or reply.

Sign in

New thread

/ 4000

📌 Pinned 🔒 Locked

·

· ·

/ 4000

🔒 This thread is locked — no new replies.

  • No threads yet — start the discussion.

Support

Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.

Sign in to open a support ticket.

Sign in

Open new ticket

Describe what you need help with. The provider team gets an email and replies on the ticket page.

  • No tickets yet for this API.

Subscription active — calls can start immediately.

Send your first request —

Subscription active — copy a snippet and fire off your first call.