---
title: "Get upcoming earnings"
method: GET
path: "/v1/earnings/{ticker}"
tags: ["Earnings"]
---

# Get upcoming earnings

`GET /v1/earnings/{ticker}`

## Request

- Base URL: `https://tradewink.fly.dev`
- URL: `https://tradewink.fly.dev/v1/earnings/{ticker}`
- Auth: HTTP bearer

Returns upcoming earnings date and estimates for a ticker.

## Path parameters

- `ticker` string, required: US stock ticker symbol (1-5 uppercase letters, optional .X suffix)

## Response `200`

Earnings information

## Other responses

- `400`: Invalid ticker
- `404`: No earnings data
- `429`: Per-key rate limit exceeded (`code: rate_limited`). Wait `Retry-After` seconds.
- `502`: Data fetch failed

---

[API](https://skmtc.dev/tradewink/apis/tradewink-rest-api.md) · [All operations](https://skmtc.dev/tradewink/apis/tradewink-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradewink/apis/tradewink-rest-api/revisions/f0a3bbe3e992?raw)