Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

market_data

Quote

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.

get/quote

Query parameters

symbolstring

Symbol ticker of the instrument

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

interval'1min' | '5min' | '15min' | '30min' | '45min' | '1h' | '2h' | '4h' | '8h' | '1day' | '1week' | '1month'

Interval of the quote

exchangestring

Exchange where instrument is traded

mic_codestring

Market Identifier Code (MIC) under ISO 10383 standard

countrystring

Country where instrument is traded, e.g., United States or US

volume_time_periodinteger

Number of periods for Average Volume

type'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'

The asset class to which the instrument belongs

format'JSON' | 'CSV'

Value can be JSON or CSV Default JSON

delimiterstring

Specify the delimiter used when downloading the CSV file

prepostboolean

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.

eodtrue | false

If true, then return data for closed day

rolling_periodinteger

Number of hours for calculate rolling change at period. By default set to 24, it can be in range [1, 168].

dpinteger

Specifies the number of decimal places for floating values Should be in range [0,11] inclusive

timezonestring

Timezone at which output datetime will be displayed. Supports:

<ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones" target="blank">here</a>.</li> </ul> <p>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.</p> <i>Take note that the IANA Timezone name is case-sensitive</i>

Response

symbolstring required

Symbol passed

namestring required

Name of the instrument

exchangestring

Exchange where instrument is traded

mic_codestring

Market identifier code (MIC) under ISO 10383 standard. Available for stocks, ETFs, mutual funds, bonds

currencystring

Currency in which the equity is denominated. Available for stocks, ETFs, mutual funds, bonds

datetimestring required

Datetime in defined timezone referring to when the bar with specified interval was opened

timestampinteger required

Unix timestamp representing the opening candle of the specified interval

last_quote_atinteger

Unix timestamp of last minute candle

openstring required

Price at the opening of current bar

highstring required

Highest price which occurred during the current bar

lowstring required

Lowest price which occurred during the current bar

closestring required

Close price at the end of the bar

volumestring

Trading volume during the bar. Available not for all instrument types

previous_closestring required

Close price at the end of the previous bar

changestring required

Close - previous_close

percent_changestring required

(Close - previous_close) / previous_close * 100

average_volumestring

Average volume of the specified period. Available not for all instrument types

rolling_1d_changestring

Percent change in price between the current and the backward one, where period is 1 day. Available for crypto

rolling_7d_changestring

Percent change in price between the current and the backward one, where period is 7 days. Available for crypto

rolling_changestring

Percent change in price between the current and the backward one, where period specified in request param rolling_period. Available for crypto

is_market_openboolean required

True if market is open; false if closed

extended_changestring

Diff between the regular close price and the latest extended price. Displayed only if prepost is true

extended_percent_changestring

Percent change in price between the regular close price and the latest extended price. Displayed only if prepost is true

extended_pricestring

Latest extended price. Displayed only if prepost is true

extended_timestampinteger

Unix timestamp of the last extended price. Displayed only if prepost is true

Example response

{
  "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",
  "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
}