The Investment entity is recovered from not only Brokers (XP, Orama, Rico) but also from retail and business Bank institutions.

The list of investments from an institution can be differentiated based on the type of the investment. Each type of investment has a set of fields that relate to the specific investment type.

Property	Type	Optional	Description
name	string	yes	Name on the provider.
code	string	yes	Investment associated code. In the case of Mutual Funds it's the CNPJ of the Fund.
isin	string	yes	12-character ISIN, a globally unique identifier.
number	string	yes	Investment number, not always provided.
owner	string	yes	Owner/beneficiary associated with the investment.
currencyCode	CurrencyCode	yes	Currency ISO code of the transaction, ie USD.
type	InvestmentType	no	Investment type.
subtype	InvestmentSubType	yes	Investment's subtype
lastMonthRate	number	yes	The interest rate for the last month.
lastTwelveMonthsRate	number	yes	Annual interest for the last 12 months.
annualRate	number	yes	Annual interest for the last year.
date	Date	yes	Value quota date.
value	number	yes	Quota's current value at `date`.
quantity	number	yes	Quantity of quota at disposal.
amount	number	no	Gross amount of the investment (tax included).
taxes	number	yes	Income taxes applied to the investment.
taxes2	number	yes	Financial taxes applied to the investment.
balance	number	no	The current net balance amount of the investment. After fees & taxes were applied.
dueDate	Date	yes	Expiration Date.
rate	number	yes	Fixed rate percentage applied to the investment.
rateType	string	yes	Type of fixed-rate (example: CDI).
fixedAnnualRate	number	yes	Fixed income annual rate (Example: 10.50).
issuer	string	yes	The entity that issued the investment.
issueDate	Date	yes	The date that the entity issued the investment.
amountProfit	number	yes	Profit to date over the investment.
amountWithdrawal	number	yes	The amount available to withdraw.
amountOriginal	number	yes	Amount originally invested.
status	InvestmentStatus	yes	Current status of the investment. ACTIVE, PENDING & TOTAL_WITHDRAWAL
institution	InvestmentInstitution	yes	Broker or Financial Institution holder of the investment. This is only returned in CEI B3 Connector.
transactions	InvestmentsTransaction	yes	List of Investments Transactions associated with Applications or Withdrawals, that affect the amount invested
metadata	InvestmentMetadata	yes	The metadata object contains "Securities's Data" for portability of Private Pensions.
providerId	string	yes	Provider institution internal identifier for the investment

Investment's Status

Value	Description
ACTIVE	Purchased and verified
PENDING	Validating purchase
TOTAL_WITHDRAWAL	Sold or transferred

Investment's Institution

Property	Type	Optional	Description
name	string	yes	Full name of the institution.
number	string	yes	Number identifier for the institution CNPJ / Other.

Investment's Types & Subtypes

To understand the nature of an investment you can rely on the investment type & subtype fields that have accurate relation with the types of investments available in Pluggy.

Type	Subtype	Description
FIXED_INCOME	CRI CRA LCI LCA LC TREASURY DEBENTURES CDB	Real Estate Receivables Certificate Agricultural Receivables Certificate Real State Credit Bill Agricultural Credit Bill Bill of Exchange National Treasury Corporate Debt Certificate of Deposit
SECURITY	RETIREMENT	Previdencia Privada
MUTUAL_FUND	INVESTMENT_FUND STOCK_FUND MULTIMARKET_FUND EXCHANGE_FUND FIXED_INCOME_FUND FIP_FUND OFFSHORE_FUND ETF_FUND	Investment Fund Stock Fund Multimarket Fund Exchange Fund (Cambial) Fixed Income Fund FIP Fund Offshore Fund ETF Fund
EQUITY	STOCK BDR REAL_ESTATE_FUND DERIVATIVES OPTION	Shares, Stocks Brazilian Depositary Receipt Real State Funds Derivatives Option
ETF	ETF	Exchange-Traded Funds
COE	STRUCTURED_NOTE

Investment's Metadata

The metadata object holds the Investment Portability information related to Security assets like Private Pension. These fields are used to provide for example "Previdencia Portability".

Property	Type	Optional	Description
taxRegime	string	yes	Regime of the tax used for the asset
proposalNumber	string	yes	Asset proposal number identification
processNumber	string	yes	Process identification number from the institution

[
  {
    "id": "f77eccf4-7714-498e-92a9-1bebe70335d9",
    "number": null,
    "name": "Bahia AM Advisory FIC de FIM",
    "balance": 1359.39,
    "currencyCode": "BRL",
    "type": "MUTUAL_FUND",
    "subtype": "INVESTMENT_FUND",
    "lastMonthRate": 0.24,
    "annualRate": 3.24,
    "lastTwelveMonthsRate": 3,
    "itemId": "207f5bcd-312a-439c-abbe-166b6632c980",
    "code": "12.345.678/0001-00",
    "value": 500,
    "quantity": 3,
    "amount": 1500,
    "taxes": 40.61,
    "taxes2": 100,
    "date": "2020-07-19T18:27:41.802Z",
    "owner": "John Doe",
    "amountProfit": null,
    "amountWithdrawal": 1310.5,
    "amountOriginal": 1000,
    "status": "ACTIVE",
    "transactions": [
      {
        "tradeDate": "2020-10-01T00:00:00.000Z",
        "date": "2020-10-01T00:00:00.000Z",
        "description": "Aplicação Fundo de Investimento Premium",
        "quantity": 1.25,
        "value": 2,
        "amount": 5,
        "type": "BUY"
      }
    ]
  },
  {
    "id": "2a96b873-53bb-4d16-a3d8-385a57e78d7e",
    "number": null,
    "name": "CDB1194KL0Z - BANCO MAXIMA S/A",
    "balance": 2000,
    "currencyCode": "BRL",
    "type": "FIXED_INCOME",
    "subtype": "CDB",
    "itemId": "207f5bcd-312a-439c-abbe-166b6632c980",
    "code": "0001-02",
    "amount": 2500,
    "taxes": null,
    "taxes2": null,
    "date": "2020-07-19T18:27:41.802Z",
    "owner": "John Doe",
    "rate": 30,
    "rateType": "CDI",
    "fixedAnnualRate": 10.5,
    "amountProfit": null,
    "amountWithdrawal": 2000,
    "amountOriginal": 1000,
    "dueDate":"2030-07-19T18:27:41.802Z",
    "issuer": "Pluggy",
    "issueDate":"2020-07-19T18:27:41.802Z",
    "status": "ACTIVE"
  },
  {
    "id": "ded7d2f1-6b90-44a8-9ace-de747b9f5bfe",
    "number": "123456-2",
    "name": "Pluggy PREVIDENCIA",
    "balance": 1359.39,
    "currencyCode": "BRL",
    "type": "SECURITY",
    "subtype": "RETIREMENT",
    "annualRate": 3.24,
    "itemId": "207f5bcd-312a-439c-abbe-166b6632c980",
    "code": null,
    "value": 500,
    "quantity": 3,
    "amount": 1500,
    "taxes": 0,
    "taxes2": 0,
    "date": "2020-07-19T18:27:41.802Z",
    "owner": "John Doe",
    "amountProfit": 359.39,
    "amountWithdrawal": 1310.5,
    "status": "ACTIVE",
    "metadata": {
      "taxRegime": "Progressivo",
      "proposalNumber": "000091322061",
      "processNumber": "15414900845201686"
    },
    "institution": {
      "name": "BANCO BTG PACTUAL S/A",
      "number": "30306294000145"
    }
  }
]

📘
See Investment in our API reference for more information.