EXT Upvest Investment API BYOL Omnibus
Number of APIs: 33
This collection was created by Upvest Developers Experience team for use by our integration partners.
Disclaimer:
This collection includes all possible API calls for the BYOL Omnibus operating model. If you are facing 403 errors, please check with your team if this feature should be enabled for your client. If this is the case, please contact the Upvest team to update your client configuration.
Prerequisites:
Install the httpsignature-proxy executable by running:
brew tap upvestco/httpsignature-proxy; brew install httpsignature-proxy
.Add and edit a file
~/.httpsignature-proxy.yaml
, please replace the{{UPPERCASE_PLACEHOLDERS}}
with their respective values:
private-key: "{{PATH_AND_FILENAME_OF_PRIVATE_KEY_FILE}}"
private-key-password: "{{PASSWORD_FOR_PRIVATE_KEY_FILE}}"
server-base-url: "https://sandbox.upvest.co"
key-id: "{{KEY_ID_FOR_PRIVATE_KEY_ISSUED_BY_UPVEST}}"
port: 3000
Start the HTTP signature proxy with this command:
httpsignature-proxy start
Place the ClientID and Client Secret provided to you by Upvest into the CURRENT VALUE column of the [collection variables] named
clientID
andclientSecret
. Do not forget to save this Qodex Collection, or else the CURRENT VALUEs of these variables could get lost.
Authorization:
Before sending any request to the Investment API, you need to acquire an adequately scoped OAuth2 access token.
You can do that by clicking on the Get New Access Token
button at the end of the Authorization
tab of this collection.
After clicking Get New Access Token
, please click also on Proceed
and Use Token
.
How to?
The collection consists of two sections: Getting Started
and Advanced
.
Please note that it is necessary to go through at least the Retrieve User
and Retrieve Account
calls of the Getting Started
section first. This will ensure that you have a valid user with everything set up for further testing of a part from the Advanced
section.
Contact Support:
Slack: type /upvest_help
in our shared Slack channel
Email: api_support@upvest.co
Portal: https://support.upvest.co/
-
Getting Started-Retrieve User - OPT/DIAG Retrieve a user GET {{proxiedPublicURL}}/users
-
Getting Started-Retrieve Account - OPT/DIAG List user account groups GET {{proxiedPublicURL}}/users/{{latestUserID}}/account_groups
-
Getting Started-Retrieve Account - OPT/DIAG List user accounts GET {{proxiedPublicURL}}/users/{{latestUserID}}/accounts
-
Getting Started-Retrieve Instruments - List instruments GET {{proxiedPublicURL}}/instruments
-
Getting Started-Retrieve Instruments - Retrieve an instrument GET {{proxiedPublicURL}}/instruments/isin:{{exampleInstrumentID}}
-
Getting Started-Place Order - Place a buy order (nominal buy) POST {{proxiedPublicURL}}/orders
-
Advanced-Instruments - Retrieve an instrument GET {{proxiedPublicURL}}/instruments/isin:{{exampleInstrumentID}}
-
Getting Started-Place Order - OPT/DIAG List account orders GET {{proxiedPublicURL}}/accounts/{{latestAccountID}}/orders
-
Getting Started-Check Position - List positions GET {{proxiedPublicURL}}/accounts/{{latestAccountID}}/positions
-
Getting Started-Check Position - Get Current Account Valuation GET {{proxiedPublicURL}}/accounts/{{latestAccountID}}/valuations/current?price_quality=EOD