# EPS trend

The EPS trend endpoint provides detailed historical data on Earnings Per Share (EPS) trends over specified periods. It returns a comprehensive breakdown of estimated EPS changes, allowing users to track and analyze the progression of a company's earnings performance over time. This endpoint is ideal for users seeking to understand historical EPS fluctuations and assess financial growth patterns.

**API credits cost:** `20` per symbol

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  Filter by symbol


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`


- `exchange` (string, optional)
  Filter by exchange name


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `meta` (object)
  Meta information about the symbol
  - `symbol` (string)
    Symbol ticker of the instrument
  - `name` (string)
    Name of the instrument
  - `currency` (string)
    Currency in which the instrument is traded
  - `exchange_timezone` (string)
    Timezone of the exchange
  - `exchange` (string)
    Exchange where the instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `type` (string)
    Type of the instrument

- `eps_trend` (array of object)
  EPS trend data
  - `date` (string)
    Date of the estimation
  - `period` (string)
    Period of estimation, can be `current_quarter`, `next_quarter`, `current_year`, or `next_year`
  - `current_estimate` (number)
    Actual EPS estimation for the period
  - `7_days_ago` (number)
    EPS estimation value 7 days ago
  - `30_days_ago` (number)
    EPS estimation value 30 days ago
  - `60_days_ago` (number)
    EPS estimation value 60 days ago
  - `90_days_ago` (number)
    EPS estimation value 90 days ago

- `status` (string)
  Status of the response


## Example Request

```bash
curl "https://api.twelvedata.com/eps_trend?symbol=AAPL&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "name": "Apple Inc",
        "currency": "USD",
        "exchange_timezone": "America/New_York",
        "exchange": "NASDAQ",
        "mic_code": "XNGS",
        "type": "Common Stock"
    },
    "eps_trend": [
        {
            "date": "2022-09-30",
            "period": "current_quarter",
            "current_estimate": 1.26,
            "7_days_ago": 1.26,
            "30_days_ago": 1.31,
            "60_days_ago": 1.32,
            "90_days_ago": 1.33
        }
    ],
    "status": "ok"
}
```