This section provides you will all you need to get started using the API. Should you have any issues however, please to not hesitate to contact us with the following means:

To use our API, you must first create an API account. You can do so here:

https://mantarisk.com/signup

Choose the "Institutional API" option.

For security reasons, a verification email will be sent to the email address you specify in the form. This email tends to find its way into junk mail so please check this too. The process is instantaneaous, if you do not receive an email within 5 mins, something went wrong somewhere.

The next step is to generate a key which you will use to programmatically authenticate when using the API.

Once logged into MantaRisk, go to the User section (see screenshot below). Here press the Generate button. The key will be generated and associated to your account.

Please make note of the key! For security reasons, it will disappear as soon as you exit the page and cannot be retrieved. If you happen to have lost your API key, then a new one needs to be generated by pressing the Generate button.

An account can only ever have one API key. Generating a new key will discard your old one and any system using the old key will no longer be able to access our API.

Our API documentation is hosted on swagger and is available here:

https://app.swaggerhub.com/apis-docs/MantaRisk/REST/0.1

Here you can choose to test against one of two servers:



Two items are required to obtain your first set of analytics:

To add a portfolio composition, you must make a PUT call to the /portfolio endpoint:

https://app.swaggerhub.com/apis-docs/MantaRisk/REST/0.1#/default/put_portfolio

The clientReference field comes from you and allows you to retrieve a given portfolio through a reference internal to your systems.

If you have just started, you will be setup with our free data source which has coverage for US stocks. You can learn more about Data Sources here.

Make sure your portfolio contains at least 2 instruments. For instance you can use TSLA, AMZN and SBUX for this step.

The risk strategy is controlled from our UI: https://mantarisk.com/strategy_builder

We suggest you use our default strategy to start with. Make note of the number preceeding the name of the strategy. This is the strategyid and you will need it for later. In the example below 106.

Your are now ready to obtain your first set of analytics. To do this you must use the /portfolio/analysis endpoint refering the clientReference and strategyid from the previous steps.

https://app.swaggerhub.com/apis-docs/MantaRisk/REST/0.1#/default/get_portfolio_analysis