Skip to main content
Sure uses market data providers to fetch security prices, search for securities, and display portfolio holdings. You can enable multiple providers simultaneously, and each security can be assigned to a specific provider.

​
Available providers

​
Configuring providers

You can enable and configure market data providers from Settings > Self-Hosting in the Sure UI. Select the providers you want to use and enter API keys where required.

​
Environment variables

You can also configure providers through environment variables. Add these to your .env file or Docker Compose configuration:
When you set SECURITIES_PROVIDERS as an environment variable, it takes precedence over the UI setting. To manage providers from the UI only, leave the environment variable unset.

​
Multiple providers

You can enable multiple securities providers at the same time. When searching for securities, Sure queries the active provider and assigns each security to the provider that found it. This lets you use different providers for different asset types — for example, Yahoo Finance for US stocks and MFAPI for Indian mutual funds. If you disable a provider that has securities assigned to it, those securities are marked offline until the provider is re-enabled.

​
Provider details

​
Yahoo Finance

Yahoo Finance is the default provider and requires no API key. It offers broad global coverage for stocks, ETFs, indices, and cryptocurrencies.
  • Rate limits: No strict API key limits, but subject to Yahoo’s usage policies
  • Coverage: Global stocks, ETFs, mutual funds, indices, crypto
  • API key: Not required
If you experience connection issues with Yahoo Finance, some IPv6 networks may have trouble reaching Yahoo’s servers. Try setting YAHOO_FINANCE_IPV6=false in your environment variables to force IPv4 connections.

​
Twelve Data

Twelve Data provides real-time and historical market data for global equities and forex. It also serves as the default exchange rate provider.
  • Rate limits: 800 API requests per day (free tier), 8 per minute
  • Coverage: Global stocks, ETFs, forex, crypto
  • API key: Required — get one at twelvedata.com

​
Tiingo

Tiingo provides end-of-day and intraday price data for US and international equities.
  • Rate limits: 500 requests per hour (free tier)
  • Coverage: US stocks, international equities, ETFs, mutual funds
  • API key: Required — get one at tiingo.com

​
EODHD

EODHD (End of Day Historical Data) provides end-of-day prices across 70+ global exchanges.
  • Rate limits: 20 API requests per day (free tier)
  • Coverage: 70+ exchanges worldwide, stocks, ETFs, mutual funds, bonds
  • API key: Required — get one at eodhd.com

​
Alpha Vantage

Alpha Vantage provides free stock, ETF, and technical data for global markets.
  • Rate limits: 25 API requests per day (free tier), with a minimum 1-second interval between requests
  • Coverage: Global stocks, ETFs, technical indicators
  • API key: Required — get one at alphavantage.co
  • History: Free tier returns approximately 100 trading days of historical data

​
MFAPI

MFAPI is a free, open-source API for Indian mutual fund NAV (Net Asset Value) data. It requires no API key.
  • Rate limits: No strict limits
  • Coverage: Indian mutual funds only (BSE-listed schemes)
  • API key: Not required