---
title: "Earliest timestamp"
method: GET
path: "/earliest_timestamp"
tags: ["reference_data"]
---

# Earliest timestamp

`GET /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.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `interval` '1min' | '5min' | '15min' | '30min' | '45min' | '1h' | '2h' | '4h' | '8h' | '1day' | '1week' | '1month', required
- `exchange` string
- `mic_code` string
- `timezone` string

## Response `200`

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

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)