The program needs stock and forex quotes for its work. It's actually a real problem, because there are a very few services that provide it for free and with reasonable API rate limits.
At this time investments uses FCS API and Finnhub, so you have to register, obtain API tokens and specify them in configuration file (see example config).
If you are client of Tinkoff broker, it's also highly recommended to obtain Tinkoff Invest API sandbox token and specify it in the config: Tinkoff has a brilliant API with very high rate limits. When token is specified in config, investments uses Tinkoff API for currency and SPB Exchange quotes + also falls back to Tinkoff SPB/OTC quotes for other exchanges for which it doesn't have quotes provider yet (LSE and HKEX for example).
There is also an option to use your own quotes provider. Add the following configuration option:
quotes:
custom_provider:
url: http://localhost/When custom provider is set the program allows you to not specify any tokens for default providers and uses it first falling back to default ones if it doesn't return requested quotes.
The API is the following: investments sends GET $url/v1/quotes?symbols=$comma_separated_symbols HTTP request and expects that the API will return quotes for all requested symbols it has access to in the following JSON format:
{
"quotes": [{
"symbol": "USD/RUB",
"price": "81.7900"
}, {
"symbol": "IWDA",
"price": "79.76",
"currency": "USD"
}]
}Here is an example of custom provider for Yahoo! Finance.
And, as a simplest workaround for various possible issues, there is an option to specify static quotes in the configuration file:
quotes:
static:
RSHE: 95.02 RUB
83010: 45.26 CNY