# Quote (High demand)

The quote endpoint provides real-time data for a selected financial instrument, returning essential information such as the latest price, open, high, low, close, volume, and price change. This endpoint is ideal for users needing up-to-date market data to track price movements and trading activity for specific stocks, ETFs, or other securities.

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

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of the instrument
  Example value: `AAPL`


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG000BHTMY7`


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


- `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
  Example value: `594918104`


- `interval` (string, optional)
  Interval of the quote
  Available values: `1min`, `5min`, `15min`, `30min`, `45min`, `1h`, `2h`, `4h`, `8h`, `1day`, `1week`, `1month`
  Default value: `1day`


- `exchange` (string, optional)
  Exchange where instrument is traded
  Example value: `NASDAQ`


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard
  Example value: `XNAS`


- `country` (string, optional)
  Country where instrument is traded, e.g., `United States` or `US`
  Example value: `United States`


- `volume_time_period` (integer, optional)
  Number of periods for Average Volume
  Default value: `9`


- `type` (string, optional)
  The asset class to which the instrument belongs
  Example value: `ETF`
  Available values: `American Depositary Receipt`, `Bond`, `Bond Fund`, `Closed-end Fund`, `Common Stock`, `Depositary Receipt`, `Digital Currency`, `ETF`, `Exchange-Traded Note`, `Global Depositary Receipt`, `Limited Partnership`, `Mutual Fund`, `Physical Currency`, `Preferred Stock`, `REIT`, `Right`, `Structured Product`, `Trust`, `Unit`, `Warrant`


- `format` (string, optional)
  Value can be JSON or CSV
Default JSON
  Available values: `JSON`, `CSV`
  Default value: `JSON`


- `delimiter` (string, optional)
  Specify the delimiter used when downloading the CSV file
  Default value: `;`


- `prepost` (boolean, optional)
  Parameter is optional. Only for the `Pro` plan (individual) and `Venture` plan (business) and above.
Available at the `1min`, `5min`, `15min`, and `30min` intervals for US equities.
Open, high, low, close values are supplied without volume.
  Default value: `false`


- `eod` (boolean, optional)
  If true, then return data for closed day
  Available values: `true`, `false`
  Default value: `false`


- `rolling_period` (integer, optional)
  Number of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168].
  Default value: `24`


- `dp` (integer, optional)
  Specifies the number of decimal places for floating values
Should be in range [0,11] inclusive
  Default value: `5`


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

Interval Limitation: The timezone parameter is only applicable for intraday intervals (less than 1 day). For intervals of 1day, 1week, or 1month, the timezone parameter is ignored, and data is strictly returned in the Exchange local time.
Take note that the IANA Timezone name is case-sensitive
  Default value: `Exchange`


**Notes:**

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

## Response

- `` (object)
  - `symbol` (string)
    Symbol passed
  - `name` (string)
    Name of the instrument
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard. Available for stocks, ETFs, mutual funds, bonds
  - `currency` (string)
    Currency in which the equity is denominated. Available for stocks, ETFs, mutual funds, bonds
  - `datetime` (string)
    Datetime in defined timezone referring to when the bar with specified interval was opened
  - `timestamp` (integer)
    Unix timestamp representing the opening candle of the specified interval
  - `last_quote_at` (integer)
    Unix timestamp of last minute candle
  - `open` (string)
    Price at the opening of current bar
  - `high` (string)
    Highest price which occurred during the current bar
  - `low` (string)
    Lowest price which occurred during the current bar
  - `close` (string)
    Close price at the end of the bar
  - `volume` (string)
    Trading volume during the bar. Available not for all instrument types
  - `previous_close` (string)
    Close price at the end of the previous bar
  - `change` (string)
    Close - previous_close
  - `percent_change` (string)
    (Close - previous_close) / previous_close * 100
  - `average_volume` (string)
    Average volume of the specified period. Available not for all instrument types
  - `rolling_1d_change` (string)
    Percent change in price between the current and the backward one, where period is 1 day. Available for crypto
  - `rolling_7d_change` (string)
    Percent change in price between the current and the backward one, where period is 7 days. Available for crypto
  - `rolling_change` (string)
    Percent change in price between the current and the backward one, where period specified in request param rolling_period. Available for crypto
  - `is_market_open` (boolean)
    True if market is open; false if closed
  - `fifty_two_week` (object)
    Collection of 52-week metrics
    - `low` (string)
      52-week low price
    - `high` (string)
      52-week high price
    - `low_change` (string)
      Current price - 52-week low
    - `high_change` (string)
      Current price - 52-week high
    - `low_change_percent` (string)
      Percentage change from 52-week low
    - `high_change_percent` (string)
      Percentage change from 52-week high
    - `range` (string)
      Range between 52-week low and high
  - `extended_change` (string)
    Diff between the regular close price and the latest extended price. Displayed only if prepost is true
  - `extended_percent_change` (string)
    Percent change in price between the regular close price and the latest extended price. Displayed only if prepost is true
  - `extended_price` (string)
    Latest extended price. Displayed only if prepost is true
  - `extended_timestamp` (integer)
    Unix timestamp of the last extended price. Displayed only if prepost is true


## Example Request

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

## Example Response

```json
{
    "symbol": "AAPL",
    "name": "Apple Inc",
    "exchange": "NASDAQ",
    "mic_code": "XNAS",
    "currency": "USD",
    "datetime": "2021-09-16",
    "timestamp": 1631772000,
    "last_quote_at": 1631772000,
    "open": "148.44000",
    "high": "148.96840",
    "low": "147.22099",
    "close": "148.85001",
    "volume": "67903927",
    "previous_close": "149.09000",
    "change": "-0.23999",
    "percent_change": "-0.16097",
    "average_volume": "83571571",
    "rolling_1d_change": "123.123",
    "rolling_7d_change": "123.123",
    "rolling_change": "123.123",
    "is_market_open": false,
    "fifty_two_week": {
        "low": "103.10000",
        "high": "157.25999",
        "low_change": "45.75001",
        "high_change": "-8.40999",
        "low_change_percent": "44.37440",
        "high_change_percent": "-5.34782",
        "range": "103.099998 - 157.259995"
    },
    "extended_change": "0.09",
    "extended_percent_change": "0.05",
    "extended_price": "125.22",
    "extended_timestamp": 1649845281
}
```