search
Search for ETFs.
An empty query returns the full list of ETFs from the provider.
Examples
from openbb import obb
# An empty query returns the full list of ETFs from the provider.
obb.etf.search(provider='fmp')
# The query will return results from text-based fields containing the term.
obb.etf.search(query='commercial real estate', provider='fmp')
Parameters
- standard
- fmp
- intrinio
- tmx
query: str
Search query.
• Optional: True
query: str
Search query.
• Optional: True
exchange: Literal['AMEX', 'NYSE', 'NASDAQ', 'ETF', 'TSX', 'EURONEXT']
The exchange code the ETF trades on.
• Optional: True
is_active: Literal[True, False]
Whether the ETF is actively trading.
• Optional: True
query: str
Search query.
• Optional: True
exchange: Literal['xnas', 'arcx', 'bats', 'xnys', 'bvmf', 'xshg', 'xshe', 'xhkg', 'xbom', 'xnse', 'xidx', 'tase', 'xkrx', 'xkls', 'xmex', 'xses', 'roco', 'xtai', 'xbkk', 'xist']
Target a specific exchange by providing the MIC code.
• Optional: True
query: str
Search query.
• Optional: True
div_freq: Literal['monthly', 'annually', 'quarterly']
The dividend payment frequency.
• Optional: True
sort_by: Literal['aum', 'return_1m', 'return_3m', 'return_6m', 'return_1y', 'return_3y', 'return_ytd', 'beta_1y', 'volume_avg_daily', 'management_fee', 'distribution_yield', 'pb_ratio', 'pe_ratio']
The column to sort by.
• Optional: True
use_cache: bool
Whether to use a cached request. All ETF data comes from a single JSON file that is updated daily. To bypass, set to False. If True, the data will be cached for 4 hours.
• Default: True
• Optional: True
Returns
results: list[EtfSearch]
Serializable results.
provider: Optional[Literal['fmp', 'intrinio', 'tmx']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- fmp
- intrinio
- tmx
symbol: str
Symbol representing the entity requested in the data.(ETF)
name: str
Name of the ETF.
symbol: str
Symbol representing the entity requested in the data.(ETF)
name: str
Name of the ETF.
market_cap: float
The market cap of the ETF.
sector: str
The sector of the ETF.
industry: str
The industry of the ETF.
beta: float
The beta of the ETF.
price: float
The current price of the ETF.
last_annual_dividend: float
The last annual dividend paid.
volume: float
The current trading volume of the ETF.
exchange: str
The exchange code the ETF trades on.
exchange_name: str
The full name of the exchange the ETF trades on.
country: str
The country the ETF is registered in.
actively_trading: Literal[True, False]
Whether the ETF is actively trading.
symbol: str
Symbol representing the entity requested in the data.(ETF)
name: str
Name of the ETF.
exchange: str
The exchange MIC code.
figi_ticker: str
The OpenFIGI ticker.
ric: str
The Reuters Instrument Code.
isin: str
The International Securities Identification Number.
sedol: str
The Stock Exchange Daily Official list.
intrinio_id: str
The unique Intrinio ID for the security.
symbol: str
Symbol representing the entity requested in the data.(ETF)
name: str
Name of the ETF.
short_name: str
The short name of the ETF.
inception_date: str
The inception date of the ETF.
issuer: str
The issuer of the ETF.
investment_style: str
The investment style of the ETF.
esg: bool
Whether the ETF qualifies as an ESG fund.
currency: str
The currency of the ETF.
unit_price: float
The unit price of the ETF.
close: float
The closing price of the ETF.
prev_close: float
The previous closing price of the ETF.
return_1m: float
The one-month return of the ETF, as a normalized percent.
return_3m: float
The three-month return of the ETF, as a normalized percent.
return_6m: float
The six-month return of the ETF, as a normalized percent.
return_ytd: float
The year-to-date return of the ETF, as a normalized percent.
return_1y: float
The one-year return of the ETF, as a normalized percent.
beta_1y: float
The one-year beta of the ETF, as a normalized percent.
return_3y: float
The three-year return of the ETF, as a normalized percent.
beta_3y: float
The three-year beta of the ETF, as a normalized percent.
return_5y: float
The five-year return of the ETF, as a normalized percent.
beta_5y: float
The five-year beta of the ETF, as a normalized percent.
return_10y: float
The ten-year return of the ETF, as a normalized percent.
beta_10y: float
The ten-year beta of the ETF.
beta_15y: float
The fifteen-year beta of the ETF.
return_from_inception: float
The return from inception of the ETF, as a normalized percent.
avg_volume: int
The average daily volume of the ETF.
avg_volume_30d: int
The 30-day average volume of the ETF.
aum: float
The AUM of the ETF.
pe_ratio: float
The price-to-earnings ratio of the ETF.
pb_ratio: float
The price-to-book ratio of the ETF.
management_fee: float
The management fee of the ETF, as a normalized percent.
mer: float
The management expense ratio of the ETF, as a normalized percent.
distribution_yield: float
The distribution yield of the ETF, as a normalized percent.
dividend_frequency: str
The dividend payment frequency of the ETF.