Skip to main content
Investment Types represent the bucket of different financial products that are available for trade on the Pipevest platform. This document will guide you on how to get investment type details.

​
Retrieving Investment Types

When requesting investment types details you can do so either by getting:
  • A list of investment types
  • An investment type by a given Id

​
List of Investment Types

Make a GET request to /investments.
  curl --request GET \
    --url https://api.pipevest.com/v1/investments\
    --header 'Authorization: Bearer 123456' \
    --header 'Signature: sig1=:OTEyMjY4...A5NTNDMEQ=:' \
    --header 'Signature-Input: sig1=("Authorization" "Content-Digest" "Content-Length" "Content-Type" "X-Client-Id" "X-Idempotency-Key" "@method" "@target-uri" "@path" "@query");keyid="staging-pipevest-ed25519";created=1732893484;expires=1732893584' \
    --header 'X-Client-Id: 123456' \
This endpoint can be paginated and sorted.

​
Investment Type by Id

Make a GET request to /investments/{investmentId} 
  curl --request GET \
    --url https://api.pipevest.com/v1/investments/123456\
    ...

​
Entity Reference

PropertyDefinition
investmentIdUnique investment identifier
investmentTypeInvestment type associated with the account
isAvailableDetermines whether the instrument is available for trading
createdAtCreated at unix timestamp
updatedAtUpdated at unix timestamp

​
Investment Types

Only INTERNATIONAL_STOCKS is currently available for trade.
NameAvailableDefinition
INTERNATIONAL_STOCKSYesAllows trading of international equities and stocks
COMMODITYNoAllows trading of raw materials and basic resources (i.e. - Gold, Mining, Agricultural Products)
BONDSNoAllows trading of bonds
LOCAL_STOCKSNoAllows trading of local equities and stocks
FOREIGN_EXCHANGENoAllows trading of fiat currencies
CRYPTONoAllows trading of crypto currencies

​
Webhook Subscriptions

SubscriptionDefinitionDomain
INVESTMENT_TYPEOnly events that deal with investment typesInvestments
INVESTMENT_TYPE.CREATEDTriggered when an investment type is createdInvestments
INVESTMENT_TYPE.UPDATEDTriggered when an investment type is updated or there is newsInvestments