# EPS revisions

The EPS revisions endpoint provides updated analyst forecasts for a company's earnings per share (EPS) on both a quarterly and annual basis. It delivers data on how these EPS predictions have changed over the past week and month, allowing users to track recent adjustments in analyst expectations. This endpoint is useful for monitoring shifts in market sentiment regarding a company's financial performance.

**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_revision` (array of object)
  EPS revision data
  - `date` (string)
    Date of the EPS estimate
  - `period` (string)
    Period of estimation, can be `current_quarter`, `next_quarter`, `current_year`, or `next_year`
  - `up_last_week` (integer)
    Number of up revisions over the last 7 days
  - `up_last_month` (integer)
    Number of up revisions over the last 30 days
  - `down_last_week` (integer)
    Number of down revisions over the last 7 days
  - `down_last_month` (integer)
    Number of down revisions over the last 30 days

- `status` (string)
  Status of the response


## Example Request

```bash
curl "https://api.twelvedata.com/eps_revisions?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_revision": [
        {
            "date": "2022-09-30",
            "period": "current_quarter",
            "up_last_week": 1,
            "up_last_month": 5,
            "down_last_week": 0,
            "down_last_month": 0
        }
    ],
    "status": "ok"
}
```