Module boosted.api.api

Functions

def addDependentData(apikey, dataset_id, dataset, proxy=None, disable_verify_ssl=False)

Adds data to an existing dependent dataset.

This uploads the data in dataset to an existing dataset. Existing date/ISIN pairs will be overwritten.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addDependentDataset or be found in your Custom Data listing in Boosted Insights.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must comprise all identifier columns in the dataset schema.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
def addDependentDataset(apikey, dataset, datasetName='DependentDataset', datasetConfig=None, proxy=None, disable_verify_ssl=False)

Creates a new dependent dataset.

Creates a new dataset by inferring a schema from your dataset. This will also upload the dataset.

See http://docs.insights.boosted.ai/integrated-data for more information on formatting.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency, or comprise all identifier columns in the dataset schema if a schema was specified
datasetName : str
Name for this dataset.
datasetConfig : DatasetConfig
A pre-configured dataset schema
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

str
Dataset ID of the newly created dataset.
def addGlobalData(apikey, dataset_id, dataset, proxy=None, disable_verify_ssl=False)

Adds data to an existing global dataset.

This uploads the data in dataset to an existing dataset. Existing date/custom security identifier pairs will be overwritten.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addGlobalDataset or be found in your Custom Data listing in Boosted Insights.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first column must be custom security identifier
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
def addGlobalDataset(apikey, dataset, datasetName='GlobalDataset', datasetConfig=None, proxy=None, disable_verify_ssl=False)

Creates a new global dataset.

Creates a new dataset by inferring a schema from your dataset. This will also upload the dataset.

See http://docs.insights.boosted.ai/global-data for more information on formatting.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex.
datasetName : str
Name for this dataset.
datasetConfig : DatasetConfig
A pre-configured dataset schema
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

str
Dataset ID of the newly created dataset.
def addIndependentData(apikey, dataset_id, dataset, proxy=None, disable_verify_ssl=False)

Adds data to an existing independent dataset.

This uploads the data in dataset to an existing dataset. Existing dates will be overwritten.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addIndependentDataset or be found in your Custom Data listing in Boosted Insights.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
def addIndependentDataset(apikey, dataset, datasetName='IndependentDataset', datasetConfig=None, proxy=None, disable_verify_ssl=False)

Creates a new independent dataset.

Creates a new dataset by inferring a schema from your dataset. This will also upload the dataset.

See http://docs.insights.boosted.ai/independent-data for more information on formatting.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first column must be a unique custom security identifier
datasetName : str
Name for this dataset.
datasetConfig : DatasetConfig
A pre-configured dataset schema
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

str
Dataset ID of the newly created dataset.
def addLiveDependentData(apikey, dataset_id, dataset, proxy=None, disable_verify_ssl=False)

Adds live data to an existing dependent dataset.

This uploads the data in dataset to an existing dataset. Existing date/ISIN pairs will be overwritten.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addDependentDataset or be found in your Custom Data listing in Boosted Insights.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
def addLiveGlobalData(apikey, dataset_id, dataset, proxy=None, disable_verify_ssl=False)

Adds live data to an existing global dataset.

This uploads the data in dataset to an existing dataset. Existing date/custom security identifier pairs will be overwritten.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addGlobalDataset or be found in your Custom Data listing in Boosted Insights.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first column must be custom security identifier
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
def addLiveIndependentData(apikey, dataset_id, dataset, proxy=None, disable_verify_ssl=False)

Adds live data to an existing independent dataset.

This uploads the data in dataset to an existing dataset. Existing dates will be overwritten.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addIndependentDataset or be found in your Custom Data listing in Boosted Insights.
dataset : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
def addSignalsToUploadedModel(apikey, model_id, upload_data, proxy=None, disable_verify_ssl=False)

Add allocations to a previously created uploaded model. The model may take a while to process asynchronously after this method returns.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
upload_data : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency by default. The remaining column must be the weight.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

list of str
Warnings incurred while uploading the allocations data.
def createBlacklist(apikey, isin, long_short=2, start_date=datetime.date(2022, 4, 28), end_date='4000-01-01', model_id=None, proxy=None, disable_verify_ssl=False)

Creates a blacklist with ISIN, long_short, start_date and end_date. If model_id is given, the blacklist will be set for the given model. long_short will default to 2, start_date will default to today, and end_date will default to 4000-01-01, unless they are provided.

Parameters

isin : string
ISIN of the blacklist to be created
long_short : int
-1: short blacklist only 1: long blacklist only 2: both
start_date : string
The created blacklist will take effect from start_date.
end_date : string
The created blacklist will take effect until end_date.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights. You must have access to the model.

Returns

Blacklist
 
___
 
def createPortfolioWithPortfolioSettings(apikey, model_id, portfolio_name, portfolio_description, portfolio_settings, proxy=None, disable_verify_ssl=False)

Create a portfolio for a model, based on provided portfolio settings. Specific portfolio settings will fall back to defaults if not provided, and no two portfolios on the same model may have the exact same set of settings. Unspecified portfolio settings keys will be defaulted to their model default values. The portfolio will be asynchronously processed/recalculated and will be available within 5-10 minutes.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
portfolio_name : str
Name of the new portfolio. Must be <= 20 characters.
portfolio_description : str
Description for the new portfolio. Must be <= 100 characters.
portfolio_settings : PortfolioSettings
A pre-configured PortfolioSettings dict.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

str
Portfolio ID of the newly created portfolio.
def createSignalsModel(apikey, upload_data, model_name='SignalsUploadModel', proxy=None, disable_verify_ssl=False)

Create a new model with uploaded signals. The model may take a while to process asynchronously after this method returns.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
upload_data : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency by default. The remaining column must be the weight.
model_name : str
Name for this model.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

2-tuple
str Model ID of the newly created model with uploaded signals. list of str Warnings incurred while uploading the allocations data.
def deleteBlacklist(apikey, blacklist_id, proxy=None, disable_verify_ssl=False)

Deletes the blacklist with given id. You must have access to the blacklist.

Parameters

blacklist_id : int
Blacklist ID. Blacklist ID can be found by running getBlacklists, or when you create a blacklist the ID of the created blacklist will be shown.

Returns

Boolean, denoting the success of deletion
 
___
 
def exportDependentDataset(apikey, dataset_id, proxy=None, disable_verify_ssl=False)

Exports an existing dependent dataset.

Exports an existing dataset identified by a dataset ID. Returns the data as a Pandas DataFrame.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addDependentDataset or be found in your Custom Data listing in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing your data that will be indexed by the date. The DataFrame schema is identical to the one used to upload a dataset.
def exportGlobalDataset(apikey, dataset_id, proxy=None, disable_verify_ssl=False)

Exports an existing global dataset.

Exports an existing dataset identified by a dataset ID. Returns the data as a Pandas DataFrame.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addGlobalDataset or be found in your Custom Data listing in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing your data that will be indexed by the date. The DataFrame schema is identical to the one used to upload a dataset.
def exportIndependentDataset(apikey, dataset_id, proxy=None, disable_verify_ssl=False)

Exports an existing independent dataset.

Exports an existing dataset identified by a dataset ID. Returns the data as a Pandas DataFrame.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addIndependentDataset or be found in your Custom Data listing in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing your data that will be indexed by the date. The DataFrame schema is identical to the one used to upload a dataset.
def getAllocationsForAllDates(apikey, portfolio_id, proxy=None, disable_verify_ssl=False)

Get the allocations for a portfolio on all dates.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing allocation information. model_id: str - Model id from accompanying portfolio allocations: dict keys: date of the allocations in the value value: list of dict - List of allocation information allocation: float - Allocation of security allocation_delta: float - Difference in allocation compared to previous trade company_name: str - Security name country: str - Security exchange region currency: str - Security currency has_trade_signal: bool - If trade was based on signal or outside reason isin: str - ISIN of security price: float - Price of security shares_owned: float - Current shares of the security shares_traded: float - Number of share traded of te security symbol: str - Symbol of the security
def getAllocationsForDate(apikey, portfolio_id, date=datetime.date(2022, 4, 28), rollback_to_last_available_date=False, proxy=None, disable_verify_ssl=False)

Get the allocations for a portfolio on a date.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
rollback_to_last_available_date : bool
Whether or not to retrieve rankings for the most recent date if the current date is not a trade date.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing allocation information: model_id: str - Model id from accompanying portfolio date: str - Date string in yyyy/mm/dd format of date of the allocation data allocations: List of dict - List of allocation information allocation: float - Allocation of security allocation_delta: float - Difference in allocation compared to previous trade company_name: str - Security name country: str - Security exchange region currency: str - Security currency has_trade_signal: bool - If trade was based on signal or outside reason isin: str - ISIN of security price: float - Price of security shares_owned: float - Current shares of the security shares_traded: float - Number of share traded of te security symbol: str - Symbol of the security
def getAllocationsForDateV2(apikey, portfolio_id, date=datetime.date(2022, 4, 28), rollback_to_last_available_date=False, proxy=None, disable_verify_ssl=False)

Get the allocations for a portfolio on a date.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
rollback_to_last_available_date : bool
Whether or not to retrieve rankings for the most recent date if the current date is not a trade date.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing allocation information: model_id: str - Model id from accompanying portfolio date: str - Date string in yyyy/mm/dd format of date of the allocation data allocations: List of dict - List of allocation information allocation: float - Allocation of security allocation_delta: float - Difference in allocation compared to previous allocation company_name: str - Security name country: str - Security exchange region currency: str - Security currency has_trade_signal: bool - If trade was based on signal or outside reason isin: str - ISIN of security price: float - Price of security shares_owned: float - Current shares of the security shares_traded: float - Number of shares traded of te security symbol: str - Symbol of the security
def getBlacklist(apikey, blacklist_id, proxy=None, disable_verify_ssl=False)

Gets blacklist with provided id. You must have access to the blacklist.

Parameters

blacklist_id : int
Blacklist ID. Blacklist ID can be found by running getBlacklists, or when you create a blacklist the ID of the created blacklist will be shown.

Returns

Blacklist
 
___
 
def getBlacklists(apikey, model_id=None, company_id=None, last_N=None, proxy=None, disable_verify_ssl=False)

Gets the list of blacklists with provided company_id or model_id. If last_N is provided, the list will return N most recently created blacklists. If no parameter is provided, the list of user company's blacklists will be returned. Note that when company_id is provided, blacklists will be returned if you have access to their model, if they are model specified. company_id and model_id cannot both be provided.

Parameters

model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights. You must have access to the model.
company_id : str
Company ID. Used by administrators to access blacklists from the given company.
last_N : int
N most recently created blacklists to return

Returns

list of Blacklists
 
___
 
def getDataSetSchema(apikey, dataset_id, proxy=None, disable_verify_ssl=False)

Retrieves a DataSetConfig representing the schema of an existing dataset.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addIndependentDataset or be found in your Custom Data listing in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

DataSetConfig
A DataSetConfig can be used to create a new dataset.
def getDatasetDates(apikey, dataset_id, proxy=None, disable_verify_ssl=False)

Gets the valid to and valid from dates of the given dataset id

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addDependentDataset or be found in your Custom Data listing in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing the valid to and from dates of the dataset { 'validFrom': datetime.date, 'validTo': datetime.date }
___
 
def getDenseSignals(apikey, model_id, portfolio_id, file_name=None, location='./', proxy=None, disable_verify_ssl=False)

Downloads the dense signal csv for the provided portfolio and model

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
file_name : str
File name of the dense signals file to save as. If no file name is given the file name will be "-_dense_signals.csv"
location : str
The location to save the file to. If no location is given then it will be saved to the current directory.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
___
 
def getFeatureImportance(apikey, model_id, date, N=None, proxy=None, disable_verify_ssl=False)

Gets the top N features for the given model sorted in descending order of importance

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
date : datetime.date or YYYY-MM-DD string
Date for the period for which features should be fetched. The resulting features are fetched for the period the date falls into. E.g. if the date is 2021-11-21 for the annual model, the features will be provided for the period of 2021-01-01 - 2021-12-31.
N : int
Limit for the number of top features to be returned. If not provided, the entire list of features will be returned.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing features and their importance
___
 
def getGbiIdFromIsinCountryCurrencyDate(apikey, isin_country_currency_dates, proxy=None, disable_verify_ssl=False)

Get the gbi securities from a isin, country, currency, date combinations

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
isin_country_currency_dates : list of IsinCountryCurrencyDate
An array of IsinCountryCurrencyDate
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

list of GbiIdSecurity
The corresponding gbi id securities
def getHistoricalTradeDates(apikey, portfolio_id, start_date=None, end_date=None, proxy=None, disable_verify_ssl=False)

Get the historical dates for which there exist trading data.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved by clicking on the copy to clipboard button next to your portfolio's name in the Tear Sheet Page of a Model.
start_date : datetime.date or YYYY-MM-DD string
Starting date for the inclusive interval of dates to search. Defaults to 1 year prior to end date if unspecified.
end_date : datetime.date or YYYY-MM-DD string
Ending date for the inclusive interval of dates to search. Defaults to today if unspecified.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing date information dates: List of str List of historical trade dates in YYYY-MM-DD format.
def getPortfolioSettings(apikey, portfolio_id, proxy=None, disable_verify_ssl=False)

Retrieve portfolio settings from an existing portfolio. The result can be modified and reused to create a new portfolio. The set of returned portfolio settings are limited to a view of ones editable as documented in PortfolioSettings only.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

PortfolioSettings
A PortfolioSettings can be used to create a new portfolio.
def getPortfolioStatus(apikey, model_id, portfolio_id, job_date, proxy=None, disable_verify_ssl=False)

Gets the update status of a portfolio

Parameters

model_id : str
The id of the model the portfolio belongs to
portfolio_id : str
The id of the portfolio
job_date : str
The date in question, in YYYY-MM-DD format

Returns

dict with properties
is_complete: bool True if the calculation for the date has been completed last_update: str The most recent date with a completed calculation next_update: str The earliest date (in the future) with an incomplete calculation
___
 
def getRanking2DateAnalysisFile(apikey, model_id, portfolio_id, date, file_name=None, location='./', proxy=None, disable_verify_ssl=False)

Downloads the ranking analysis file for the provied portfolio and model. If no file exist then it will send a request to generate the file and continuously poll the server every 5 seconds to try and download the file until the file is downlaoded.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : datetime.date or YYYY-MM-DD string
Date of the data to retrieve.
file_name : str
File name of the dense signals file to save as. If no file name is given the file name will be "-statistical_analysis.xlsx"
location : str
The location to save the file to. If no location is given then it will be saved to the current directory.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
___
 
def getRanking2DateExplainFile(apikey, model_id, portfolio_id, date, file_name=None, location='./', proxy=None, disable_verify_ssl=False)

Downloads the ranking explain file for the provied portfolio and model. If no file exist then it will send a request to generate the file and continuously poll the server every 5 seconds to try and download the file until the file is downlaoded.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : datetime.date or YYYY-MM-DD string
Date of the data to retrieve.
file_name : str
File name of the dense signals file to save as. If no file name is given the file name will be "-explain_data.xlsx"
location : str
The location to save the file to. If no location is given then it will be saved to the current directory.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

None
 
___
 
def getRankingAnalysis(apikey, model_id, date, proxy=None, disable_verify_ssl=False)

Gets the ranking 2.0 analysis data for the given model on the given date

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
date : datetime.date or YYYY-MM-DD string
Date of the data to retrieve.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing your data indexed by data buckets and feature names.
___
 
def getRankingExplain(apikey, model_id, date, proxy=None, disable_verify_ssl=False)

Gets the ranking 2.0 explain data for the given model on the given date

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
date : datetime.date or YYYY-MM-DD string
Date of the data to retrieve.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing your data indexed by ISINs and feature names.
___
 
def getRankingsForAllDates(apikey, portfolio_id, proxy=None, disable_verify_ssl=False)

Get all rankings data for a portfolio.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

Dictionary containing rankings information:
model_id: str - Model id that the portfolio belongs to rankings: dict keys: dates requested in yyyy/mm/dd format, model_id value: list of dict - Rankings info per security in the portfolio symbol: str - Symbol of the security isin: str - The International Securities Identification Number of the security country: str - Three character country code currency: str - The currency short length code rank: int - the ranking from 1 (top) companyName: str - The name of the company who owns the security delta: int - The change in ranking from the last data point, first will be null
def getRankingsForDate(apikey, portfolio_id, date=datetime.date(2022, 4, 28), rollback_to_last_available_date=False, proxy=None, disable_verify_ssl=False)

Get the rankings data for a portfolio on a date.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
rollback_to_last_available_date : bool
Whether or not to retrieve rankings for the most recent date if the current date is not a trade date.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

Dictionary containing rankings information:
model_id: str - Model id that the portfolio belongs to date: str - Date string in yyyy/mm/dd format of date of the ranking data rankings: List of dict - Rankings info per security in the portfolio symbol: str - Symbol of the security isin: str - The International Securities Identification Number of the security country: str - Three character country code currency: str - The currency short length code rank: int - the ranking from 1 (top) companyName: str - The name of the company who owns the security delta: int - The change in ranking from the last data point, first will be null
def getSignalsForAllDates(apikey, portfolio_id, proxy=None, disable_verify_ssl=False)

Get the signals for all dates in the portfolio.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing signals information: model_id: str - Model id from accompanying portfolio signals: dict keys: date of the signals in the value value: list of dict - List of signal information per model signals_info: List of dict - Signal information for each security per model id company_name: str - Security name country: str - Security exchange region currency: str - Security currency date: str - Date string in yyyy/mm/dd format of date requested isin: str - ISIN of security signal: float - Signal from model signal_delta: float - Change in signal compared to last trade symbol: str - Symbol of the security
def getSignalsForDate(apikey, portfolio_id, date=datetime.date(2022, 4, 28), rollback_to_last_available_date=False, proxy=None, disable_verify_ssl=False)

Get the signals for a portfolio on a date.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
rollback_to_last_available_date : bool
Whether or not to retrieve rankings for the most recent date if the current date is not a trade date.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing signals information: date: str - Date string in yyyy/mm/dd format of date of the signal data signals: List of dict - List of signal information per model model_id: str - Model id from accompanying portfolio signals_info: List of dict - Signal information for each security per model id company_name: str - Security name country: str - Security exchange region currency: str - Security currency isin: str - ISIN of security signal: float - Signal from model signal_delta: float - Change in signal compared to last trade symbol: str - Symbol of the security
def getSignalsFromUploadedModelForAllDates(apikey, model_id, proxy=None, disable_verify_ssl=False)

Retrieve uploaded signal information for a uploaded model for all dates.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

List of signal information
 

date: str - Date string in yyyy/mm/dd format of date requested isin: str - The International Securities Identification Number of the security country: str - Three character country code currency: str - The currency short length code weight: float - signal value

def getSignalsFromUploadedModelForDate(apikey, model_id, date=datetime.date(2022, 4, 28), proxy=None, disable_verify_ssl=False)

Retrieve uploaded signal information for a uploaded model for one date.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

List of signal information
 

date: str - Date string in yyyy/mm/dd format of date requested isin: str - The International Securities Identification Number of the security country: str - Three character country code currency: str - The currency short length code weight: float - signal value

def getTearSheet(apikey, model_id, portfolio_id, proxy=None, disable_verify_ssl=False, start_date=None, end_date=None, block=False)

Gets the model and portfolio's tear sheet and returns it as a list of tear sheet groups

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
start_date : str or None
Start date for the range of data represented by the tear sheet (YYYY-MM-DD)
end_date : str or None
End date for the range of data represented by the tear sheet (YYYY-MM-DD) Must be None if and only if start_date is None
block : bool
Whether or not to wait for the data to be ready. No effect if dates are not provided

Returns

List
Each element in the list represents a group in the tearsheet. i.e Risk Adjusted Returns Each dictionary is made of member which is a list of dicts representing a tearsheet value and a group name which is the name of the group shown on screen. Each dict in the member array has value which is a floating point number, type which is either "number" or "precent" to determine if value is a raw number or a percentage value, and finally "name" which is the name shown on screen. [ { members: [ { "value": float, "type": str, "name": str }, ], group_name: str }, ]
___
 
def getTradeExplain(apikey, portfolio_id, date=None, proxy=None, disable_verify_ssl=False)

Get the trade explanations for a particular model on a specified date. If no date is given the function will return all data on all trading days.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
portfolio_id : str
Portfolio ID. Portfolio IDs can be retrieved from portfolio's configuration page.
date : str
datetime.date or YYYY-MM-DD string Date of the trade explain to return. If no date is given the function will return all data on all trading days.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing your data that will be indexed by the date.
___
 
def getUniverse(apikey, model_id, date=None, proxy=None, disable_verify_ssl=False)

Returns the universe members of a model.

Returns the members of the universe of a model. If no date is provided, effective date ranges will be returned. If a date is provided, only the universe members of that date are returned. The results are returned in a Pandas DataFrame.

For more information, see http://docs.insights.boosted.ai/universe-upload.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

pandas.DataFrame
Pandas DataFrame containing the universe members. If a date was provided, only ISIN, Country, and Currency are returned. If no date was provided, returns From, To, ISIN, Country, Currency.
def inferDependentDataSetSchema(name, df, infer_from_column_names=False)

Creates a dependent dataset schema by inferring the contents from a Pandas DataFrame.

Parameters

datasetName : str
Name for this dataset.
df : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency by default.
infer_from_column_names : bool
Allows creation of dataset schemas with more flexible identifier columns. Identifier column names must be specified equal to (case and whitespace insensitive) one of the values in boosted.api.api_type.ColumnSubRole. These columns must be grouped together as a block in the first N columns of your dataset, where N is the number of identifiers.

Returns

DatasetConfig
A DatasetConfig can be used to create a new dataset.
def inferDependentForwardQuarterlyDataSetSchema(name, df, infer_dataset_report_period=True, infer_from_column_names=False)

Creates a dependent dataset schema by inferring the contents from a Pandas DataFrame.

Parameters

datasetName : str
Name for this dataset.
df : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency by default.
infer_from_column_names : bool
Allows creation of dataset schemas with more flexible identifier columns. Identifier column names must be specified equal to (case and whitespace insensitive) one of the values in boosted.api.api_type.ColumnSubRole. These columns must be grouped together as a block in the first N columns of your dataset, where N is the number of identifiers.
infer_dataset_report_period : bool
Allow the report period to be inferred based on the report date

Returns

DatasetConfig
A DatasetConfig can be used to create a new dataset.
def inferDependentHistoricalQuarterlyDataSetSchema(name, df, infer_dataset_report_period=True, infer_from_column_names=False)

Creates a dependent dataset schema by inferring the contents from a Pandas DataFrame.

Parameters

datasetName : str
Name for this dataset.
df : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first columns must be ISIN, Country, Currency by default.
infer_from_column_names : bool
Allows creation of dataset schemas with more flexible identifier columns. Identifier column names must be specified equal to (case and whitespace insensitive) one of the values in boosted.api.api_type.ColumnSubRole. These columns must be grouped together as a block in the first N columns of your dataset, where N is the number of identifiers.
infer_dataset_report_period : bool
Allow the report period to be inferred based on the report date

Returns

DatasetConfig
A DatasetConfig can be used to create a new dataset.
def inferGlobalDataSetSchema(name, df)

Creates a independent dataset schema by inferring the contents from a Pandas DataFrame.

Parameters

datasetName : str
Name for this dataset.
df : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex.

Returns

DatasetConfig
A DatasetConfig can be used to create a new dataset.
def inferIndependentDataSetSchema(name, df)

Creates a independent dataset schema by inferring the contents from a Pandas DataFrame.

Parameters

datasetName : str
Name for this dataset.
df : pandas.DataFrame
Pandas DataFrame containing your data. The index must be DatetimeIndex. The first column must be a unique custom security identifier

Returns

DatasetConfig
A DatasetConfig can be used to create a new dataset.
def queryDataset(apikey, dataset_id, proxy=None, disable_verify_ssl=False)

Queries the status, timerange of a dataset.

Returns meta-information about a dataset. This can be used to check the dateranges covered and the current status.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
dataset_id : str
Dataset ID. Can be from the output of addDependentDataset or be found in your Custom Data listing in Boosted Insights.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

dict:
Dictionary containing meta-data about the dataset.
'created': <creation date>,
'fileSize': <file size>,
'id': <dataset ID>,
'name': <dataset name>,
'ownerId': <owner ID>,
'region': <dataset region>,
'status': {AVAILABLE|UPDATING|CREATING|ERROR},
'type': {STOCK|STRATEGY|GLOBAL},
'universeId': <universe ID>,
'validFrom': [YYYY, MM, DD],
'validTo': [YYYY, MM, DD]}
def updateBlacklist(apikey, blacklist_id, long_short=None, start_date=None, end_date=None, proxy=None, disable_verify_ssl=False)

Updates the blacklist with given id. You must have access to the blacklist. long_short, start_date and end_date are all optional.

Parameters

blacklist_id : int
Blacklist ID. Blacklist ID can be found by running getBlacklists, or when you create a blacklist the ID of the created blacklist will be shown.
long_short : int
-1: short blacklist only 1: long blacklist only 2: both
start_date : string
The created blacklist will take effect from start_date.
end_date : string
The created blacklist will take effect until end_date.

Returns

Blacklist
 
___
 
def updateUniverse(apikey, model_id, universe_df, date=datetime.date(2022, 4, 29), proxy=None, disable_verify_ssl=False)

Sets the universe members of a model.

Sets the members of the universe of a model. Universe members may only be set for future dates.

For more information, see http://docs.insights.boosted.ai/universe-upload.

Parameters

apikey : str
API key provided by Boosted. This key should be protected as a secret.
model_id : str
Model ID. Model IDs can be retrieved by clicking on the copy to clipboard button next to your model's name in the Model Summary Page in Boosted Insights.
universe_df : Pandas.DataFrame
A Pandas.DataFrame with columns ISIN, Country, Currency.
date : datetime.date or YYYY-MM-DD string
Date of the universe to retrieve.
proxy : str
Your organization may require the use of a proxy for access. The address of a HTTPS proxy in the format of
:. Examples are "123.456.789:123" or "my.proxy.com:123". Do not prepend with "https://".
disable_verify_ssl : bool
Your networking setup may be behind a firewall which performs SSL inspection. Either set the REQUESTS_CA_BUNDLE environment variable to point to the location of a custom certificate bundle, or set this parameter to true to disable SSL verification as a workaround.

Returns

str
Any warnings, e.g. failure to map ISINs, are returned.