Interface SymbolSource

public interface SymbolSource

Interface for searching financial instrument symbols.

Implementations query various data sources to find ticker symbols matching a search expression.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	SymbolSource.SymbolInfo	Basic symbol information.

Method Summary

Modifier and Type	Method	Description
default String	getSourceName()	Returns the name of this symbol source.
default SymbolSource.SymbolInfo	getSymbolInfo(String symbol)	Returns detailed information about a specific symbol.
Set<String>	search(String expression)	Searches for symbols matching the given expression.

Method Details

search

Set<String> search(String expression)
            throws UnavailableDataException

Searches for symbols matching the given expression.

Parameters:

expression - the search string (company name or partial symbol)

Returns:

set of matching symbols

Throws:

UnavailableDataException - if the search cannot be performed

IllegalArgumentException - if expression is null or empty

getSymbolInfo

default SymbolSource.SymbolInfo getSymbolInfo(String symbol)
                                       throws UnavailableDataException

Returns detailed information about a specific symbol.

Parameters:

symbol - the ticker symbol

Returns:

information about the symbol, or null if not found

Throws:

UnavailableDataException - if data cannot be retrieved

getSourceName

default String getSourceName()

Returns the name of this symbol source.

Returns:

the source name