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
ofstr
- 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
ofdeletion
___
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
orYYYY-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
orYYYY-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
ofBlacklists
___
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
orYYYY-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
ofIsinCountryCurrencyDate
- 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
ofGbiIdSecurity
- 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
orYYYY-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
orYYYY-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
orYYYY-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
orYYYY-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
orYYYY-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
orYYYY-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
orYYYY-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
orYYYY-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
ofsignal 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
orYYYY-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
ofsignal 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
orNone
- Start date for the range of data represented by the tear sheet (YYYY-MM-DD)
end_date
:str
orNone
- 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
orYYYY-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
orYYYY-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.