# Zacks — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Compare a company's actual earnings per share against analyst expectations for the last four quarters to see how often it beats or misses forecasts. Access the surprise percentage and positive surprise ratio to quickly identify stocks with a consistent track record of outperforming estimates.

**Category:** Finance & Markets | **Website:** [www.zacks.com/stock/quote/AAPL?q=AAPL&icid=quote-stock_overview-search_popular-zcom-main_menu_wrapper-AAPL](https://www.zacks.com/stock/quote/AAPL?q=AAPL&icid=quote-stock_overview-search_popular-zcom-main_menu_wrapper-AAPL) | **Docs:** [parse.bot/marketplace/f7e37144-fc8a-47a1-b2a8-b03fd4b46359/zacks-com-api](https://parse.bot/marketplace/f7e37144-fc8a-47a1-b2a8-b03fd4b46359/zacks-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-zacks-com-api-f7e37144/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_eps_surprise_ratio

Fetches the EPS Surprise (last 4 quarters) section from a stock's Zacks quote overview page. Returns four quarters in newest-to-oldest order with reported EPS, estimated EPS, difference, and EPS surprise percentage. Computes positive_surprise_ratio as the count of quarters with strictly positive surprise percentage divided by 4. If any quarter's EPS Surprise % is N/A or missing, positive_surprise_ratio is null and ratio_status is 'no_info'. One upstream page request per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ticker` | string | Yes | Stock ticker symbol (1-5 uppercase letters, optionally followed by a dot or hyphen and 1-2 letters for share classes like BRK.B). Example: AAPL, MSFT, BRK.B. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zacks-com-api-f7e37144/get_eps_surprise_ratio \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticker":"<string>"}'
```