# Earliest timestamp

The earliest_timestamp endpoint provides the earliest available date and time for a specified financial instrument at a given data interval. This endpoint is useful for determining the starting point of historical data availability for various assets, such as stocks or currencies, allowing users to understand the time range covered by the data.

**API credits cost:** `1` per request

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of the instrument.


- `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


- `interval` (string, required)
  Interval between two consecutive points in time series.


- `exchange` (string, optional)
  Exchange where instrument is traded.


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard.


- `timezone` (string, optional)
  Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive


**Notes:**

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

## Response

- `` (object)
  - `datetime` (string)
    Earliest datetime, the format depends on interval
  - `unix_time` (integer)
    Datetime converted to UNIX timestamp


## Example Request

```bash
curl "https://api.twelvedata.com/earliest_timestamp?symbol=AAPL&interval=1day&apikey=demo"
```

## Example Response

```json
{
    "datetime": "1980-12-12",
    "unix_time": 345479400
}
```