# QI Tech — Investment-as-a-Service › Asset / Fund Shares Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 7 página(s). Índice: - Financial Applications Query by Fund Class (/en/documentation/iaas/cotas_de_fundo/consulta_paginada_aplicacoes_financeiras) - Fund Class Redemption Request Query (/en/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates) - Issuance Series Query (/en/documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao) - Fund Quota Position Query (/en/documentation/iaas/cotas_de_fundo/consulta_posicoes_cotas_de_fundo) - Introduction (/en/documentation/iaas/cotas_de_fundo/inicio) - Create Financial Application (/en/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras) - Create Redemption Request (/en/documentation/iaas/cotas_de_fundo/operacao_resgates) --- # Financial Applications Query by Fund Class URL: /en/documentation/iaas/cotas_de_fundo/consulta_paginada_aplicacoes_financeiras Returns, paginated, the financial applications your fund class has made in quotas of other funds. :::info Available on | Profile | Host | Required permission | | ---------- | ---------------- | ----------------------------------------- | | Manager | `manager-api` | Read | | Consultant | `consultant-api` | View Applications, Redemptions and Series | Base URL for each host: [Environments (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_applications METHOD GET ### Query Params | Parameter | Type | Description | | ---------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- | | `page` | int | Page number, starting at `0`. Default: `0`. | | `limit` | int | Records per page. Default: `10`. Maximum: `50`. | | `quotation_date` | date | Exact quotation date (`YYYY-MM-DD`). | | `quotation_date_from` | date | Start quotation date (`YYYY-MM-DD`). | | `quotation_date_to` | date | End quotation date (`YYYY-MM-DD`). Cannot be earlier than `quotation_date_from`. | | `financial_application_status` | list | Statuses to include, comma-separated (e.g. `pending_manager_approval,pending_payment`). | | `not_financial_application_status` | list | Statuses to exclude, comma-separated. | | `document_number` | string | CNPJ of the invested fund class, with punctuation. Exact match. | | `internal_codes` | list | Internal codes of the invested series, comma-separated. | | `asset_type` | string | Asset type (e.g. `fidc_fund_quota`, `multi_market_fund_quota`). | | `sub_class_name` | list | Subclass names of the invested series, comma-separated (accent- and case-insensitive). | | `search` | string | Partial search on the invested fund's short name, the series name, the internal code or the CNPJ. | The possible statuses are listed in [Create Financial Application](/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras#response). ## Response STATUS 200 Case 01: Return with one application ```json { "data": [ { "amount": 0.00, "financial_application_key": "UUID", "asset_key": "UUID", "quotation_date": "YYYY-MM-DD", "status": "confirmed", "issuance_serie": { "issuance_serie_key": "UUID", "name": "Invested Issuance Serie Name", "subclass_name": "Invested Sub Class Name", "serie": 1, "quota_calculation_method": "quota_value", "internal_code": "Internal Code", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class short name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "multi_market", "payment_type": "transfer", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "YYYY-MM-DD", "administrator": { "administrator_key": "UUID", "name": "Administrator Name", "document_number": "00.000.000/0000-00" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "amortization_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } }, "isin_code": "BR000000000" }, "fund_class": { "fund_class_key": "UUID", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "YYYY-MM-DD", "distributor": { "name": "Distributor Name", "distributor_key": "UUID", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "UUID", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Page | Field | Type | Description | |---------------|--------|--------------------------------------------------------------------------------| | `data` | array | List of **[Financial Application](#financial_application)** objects | | `limit` | int | Limit of objects retrieved per page | | `page` | int | Retrieved page number | | `is_last_page`| boolean| Information indicating if the retrieved page is the last one | ### Financial Application {#financial_application} | Field | Type | Description | | ------------------------------------ | ------ | ----------------------------------------------- | | amount | float | Applied amount | | financial_application_key | string | Unique key of the financial application | | asset_key | string | Related asset key | | quotation_date | string | Quotation date (YYYY-MM-DD) | | payment_date | string | Payment date (YYYY-MM-DD) | | payment_method | string | `wire_transfer` or `pix` | | payment_type | string | `transfer` or `automatic_debit` | | status | string | Application status | | external_financial_application_key | string | External identifier of the financial application | | iof_amount | float | Application IOF; present when calculated | | number_of_quotas | float | Number of quotas; present after quotation | | issuance_serie | JSON | **[Issuance Serie](#issuance-serie)** object | | fund_class | JSON | **[Fund Class](#fund-class)** object | ### Issuance Serie | Field | Type | Description | | ----------------------------- | ------ | ----------------------------------------------------- | | issuance_serie_key | string | Unique key of the issuance series | | name | string | Name of the issuance series | | subclass_name | string | Subclass name (ex: SUBORDINADA) | | serie | int | Series number | | quota_calculation_method | string | Quota calculation method (ex: quota_value) | | internal_code | string | Internal code of the series | | fund_class_name | string | Name of the fund class associated with the series | | fund_class_short_name | string | Short name of the fund class | | fund_class_document_number | string | CNPJ of the fund class | | minimum_share_capital | float | Minimum value for application | | investment_category | string | Investment category (ex: multi_market) | | payment_type | string | Payment type (ex: transfer) | | account_data | JSON | **[Account Data](#account-data)** object | | last_updated_date | string | Last update date (YYYY-MM-DD) | | administrator | JSON | **[Administrator](#administrator)** object | | operation_periods | JSON | **[Operation Periods](#operation-periods)** object | | isin_code | string | ISIN code of the series | ### Administrator | Field | Type | Description | | ------------------ | ------ | ---------------------------- | | administrator_key | string | Unique key of the administrator | | name | string | Administrator name | | document_number | string | Administrator CNPJ | ### Operation Periods | Field | Type | Description | | ---------------------- | ---- | ---------------------------------------------------------------------------------------- | | redemption_request | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for redemptions | | amortization_request | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for amortizations | | financial_application | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for applications | ### Quotation and Payment | Field | Type | Description | | -------------- | ------ | ------------------------------------------------ | | days | int | Number of days | | type | string | Counting type (ex: fixed, until) | | calendar_base | string | Calendar base (ex: workdays, calendar_365) | ### Account Data | Field | Type | Description | | ---------------------------- | ------ | ------------------------------------------------------------- | | account_digit | string | Bank account digit | | account_branch | string | Bank branch number | | account_number | string | Bank account number | | financial_institution_code | string | Financial institution code | | financial_institution_ispb | string | Financial institution ISPB (Brazilian Payment System) | ### Fund Class | Field | Type | Description | | ---------------- | ------ | --------------------------------------- | | fund_class_key | string | Unique key of the fund class | | name | string | Full name of the fund class | | short_name | string | Short name of the fund class | | document_number | string | CNPJ of the fund class | | accounting_date | string | Most recent accounting date | | distributor | JSON | **[Distributor](#distributor)** object | | manager | JSON | **[Manager](#manager)** object | ### Distributor | Field | Type | Description | | ---------------- | ------ | --------------------------- | | name | string | Distributor name | | distributor_key | string | Unique key of the distributor | | document_number | string | Distributor CNPJ | ### Manager | Field | Type | Description | | ---------------- | ------ | --------------------------------- | | manager_key | string | Unique key of the manager | | manager_name | string | Name of the fund class manager | | document_number | string | Manager CNPJ | ## Errors | Status | Code | When it happens | | ------ | ----------- | ------------------------------------------------------------ | | 400 | `TFQ000218` | `quotation_date_from` later than `quotation_date_to`. | | 403 | `TFQ000054` | The fund class does not belong to your manager. | | 404 | `TFQ000005` | Fund class not found. | Authentication, permission and host errors: see [API Errors](/documentation/iaas/introducao/erros). --- # Fund Class Redemption Request Query URL: /en/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates Returns, paginated, the redemption requests your fund class has made in quotas of other funds. :::info Available on | Profile | Host | Required permission | | ---------- | ---------------- | ----------------------------------------- | | Manager | `manager-api` | Read | | Consultant | `consultant-api` | View Applications, Redemptions and Series | Base URL for each host: [Environments (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_requests METHOD GET ### Query Params | Parameter | Type | Description | | ------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- | | `page` | int | Page number, starting at `0`. Default: `0`. | | `limit` | int | Records per page. Default: `10`. Maximum: `50`. | | `quotation_date` | date | Exact quotation date (`YYYY-MM-DD`). | | `quotation_date_from` | date | Start quotation date (`YYYY-MM-DD`). | | `quotation_date_to` | date | End quotation date (`YYYY-MM-DD`). | | `redemption_request_status` | list | Statuses to include, comma-separated. | | `not_redemption_request_status` | list | Statuses to exclude, comma-separated. | | `document_number` | string | CNPJ of the invested fund class, with punctuation. Exact match. | | `internal_codes` | list | Internal codes of the invested series, comma-separated. | | `asset_type` | string | Asset type (e.g. `fidc_fund_quota`, `multi_market_fund_quota`). | | `sub_class_name` | list | Subclass names of the invested series, comma-separated (accent- and case-insensitive). | | `search` | string | Partial search on the invested fund's short name, the series name, the internal code or the CNPJ. | The possible statuses are listed in [Create Redemption Request](/documentation/iaas/cotas_de_fundo/operacao_resgates#response). ## Response STATUS 200 Case 01: Return with one redemption ```json { "data": [ { "redemption_request_key": "UUID", "status": "confirmed", "quotation_date": "YYYY-MM-DD", "payment_date": "YYYY-MM-DD", "amount": 0.00, "issuance_serie": { "issuance_serie_key": "UUID", "name": "Issuance Serie Name", "subclass_name": "SUBORDINADA", "serie": 1, "quota_calculation_method": "quota_value", "internal_code": "Internal Code", "fund_class_name": "Fund Class Name", "fund_class_short_name": "Fund Class Short Name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "fixed_income", "payment_type": "automatic_debit", "financial_institution_code": "341", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "YYYY-MM-DD", "administrator": { "administrator_key": "UUID", "name": "Administrator Name", "document_number": "00.000.000/0000-00" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "amortization_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } } }, "fund_class": { "fund_class_key": "UUID", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "YYYY-MM-DD", "distributor": { "name": "Distributor Name", "distributor_key": "UUID", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "UUID", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Page | Field | Type | Description | | -------------- | ------- | ------------------------------------------------------------- | | `data` | array | List of **[Redemption Request](#redemption-request)** objects | | `limit` | int | Limit of objects retrieved per page | | `page` | int | Retrieved page number | | `is_last_page` | boolean | Information indicating if the retrieved page is the last one | ### Redemption Request | Field | Type | Description | | ---------------------------------- | ------ | ------------------------------------------- | | redemption_request_key | string | Unique key for the redemption request | | external_redemption_request_key | string | External control key (optional) | | status | string | Redemption status (e.g., confirmed) | | quotation_date | string | Redemption quotation date | | payment_date | string | Redemption payment date | | amount | float | Redeemed amount | | redeem_all | boolean | `true` when the request is a full redemption; omitted otherwise | | cash_expectation | JSON | Cash expectation of the redemption; present when created | | issuance_serie | JSON | **[Issuance Serie](#issuance-serie)** object | | fund_class | JSON | **[Fund Class](#fund-class)** object | ### Issuance Serie | Field | Type | Description | | ----------------------------- | ------ | ---------------------------------------------------- | | issuance_serie_key | string | Unique key for the issuance series | | name | string | Name of the issuance series | | subclass_name | string | Subclass name (e.g., SUBORDINADA) | | serie | int | Series number | | quota_calculation_method | string | Quota calculation method (e.g., quota_value) | | internal_code | string | Series internal code | | fund_class_name | string | Name of the fund class associated with the series | | fund_class_short_name | string | Short name of the fund class | | fund_class_document_number | string | CNPJ of the fund class | | minimum_share_capital | float | Minimum value for investment | | investment_category | string | Investment category (e.g., multi_market) | | payment_type | string | Payment type (e.g., transfer) | | account_data | JSON | **[Account Data](#account-data)** object | | last_updated_date | string | Last update date (YYYY-MM-DD) | | administrator | JSON | **[Administrator](#administrator)** object | | operation_periods | JSON | **[Operation Periods](#operation-periods)** object | | isin_code | string | ISIN code of the series | ### Administrator | Field | Type | Description | | ------------------ | ------ | ------------------------- | | administrator_key | string | Unique administrator key | | name | string | Administrator name | | document_number | string | Administrator CNPJ | ### Operation Periods | Field | Type | Description | | ---------------------- | ---- | ---------------------------------------------------------------------------------------- | | redemption_request | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for redemptions | | amortization_request | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for amortizations | | financial_application | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for applications | ### Quotation and Payment | Field | Type | Description | | -------------- | ------ | ----------------------------------------------- | | days | int | Number of days | | type | string | Count type (e.g., fixed, until) | | calendar_base | string | Calendar base (e.g., workdays, calendar_365) | ### Account Data | Field | Type | Description | | ---------------------------- | ------ | ---------------------------------------------------------------- | | account_digit | string | Bank account digit | | account_branch | string | Bank branch number | | account_number | string | Bank account number | | financial_institution_code | string | Financial institution code | | financial_institution_ispb | string | Financial institution ISPB (Brazilian Payment System) | ### Fund Class | Field | Type | Description | | ---------------- | ------ | ---------------------------------------- | | fund_class_key | string | Unique fund class key | | name | string | Full name of the fund class | | short_name | string | Short name of the fund class | | document_number | string | CNPJ of the fund class | | accounting_date | string | Most recent accounting date | | distributor | JSON | **[Distributor](#distributor)** object | | manager | JSON | **[Manager](#manager)** object | ### Distributor | Field | Type | Description | | ---------------- | ------ | ---------------------- | | name | string | Distributor name | | distributor_key | string | Unique distributor key | | document_number | string | Distributor CNPJ | ### Manager | Field | Type | Description | | ---------------- | ------ | ------------------------- | | manager_key | string | Unique manager key | | manager_name | string | Fund class manager name | | document_number | string | Manager CNPJ | ## Errors | Status | Code | When it happens | | ------ | ----------- | ------------------------------------------------------------ | | 400 | `TFQ000218` | `quotation_date_from` later than `quotation_date_to`. | | 403 | `TFQ000054` | The fund class does not belong to your manager. | | 404 | `TFQ000005` | Fund class not found. | Authentication, permission and host errors: see [API Errors](/documentation/iaas/introducao/erros). --- # Issuance Series Query URL: /en/documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao Returns, paginated, the fund issuance series registered for quota investment. Use the returned `issuance_serie_key` to [create an application](/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras) or [a redemption request](/documentation/iaas/cotas_de_fundo/operacao_resgates). :::info Available on | Profile | Host | Required permission | | ---------- | ---------------- | ----------------------------------------- | | Manager | `manager-api` | Read | | Consultant | `consultant-api` | View Applications, Redemptions and Series | For a consultant, the list only includes the series of fund classes linked to the consultant; with no link, `data` is empty. Base URL for each host: [Environments (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/issuance_series METHOD GET ### Query Params | Parameter | Type | Description | | ---------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------- | | `page` | int | Page number, starting at `0`. Default: `0`. | | `limit` | int | Records per page. Default: `10`. Maximum: `100`. | | `fund_class_document_number` | string | CNPJ of the series' fund, with punctuation (e.g. `11.222.333/0001-81`). Partial match. | | `fund_class_name` | string | Name of the series' fund. Partial match. | | `internal_code` | string | Internal code of the series. Partial match. | | `internal_codes` | list | Internal codes, comma-separated. Exact match. | | `status` | list | Statuses to include: `created`, `active`, `inactive`, `pre_operational`. Without this filter, `inactive` series are not returned. | | `not_status` | list | Statuses to exclude, comma-separated. | | `sub_class_name` | list | Subclass names, comma-separated (accent- and case-insensitive). | | `search` | string | Partial search on the fund's short name, the series name, the internal code or the CNPJ. | ## Response STATUS 200 Case 01: Return with one series ```json { "data": [ { "issuance_serie_key": "UUID", "name": "Invested Issuance Serie Name", "subclass_name": "Invested Sub Class Name", "serie": 1, "quota_calculation_method": "quota_value", "condominium_type": "open_ended", "internal_code": "Internal Code", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class short name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "multi_market", "asset_type": "multi_market_fund_quota", "payment_type": "transfer", "status": "active", "financial_institution_code": "329", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "YYYY-MM-DD", "administrator": { "administrator_key": "UUID", "name": "Administrator Name", "document_number": "00.000.000/0000-00", "status": "active" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "amortization_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } }, "isin_code": "BR000000000" } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Page | Field | Type | Description | |---------------|--------|------------------------------------------------------------------------------| | `data` | array | List of **[Issuance Serie](#issuance_serie)** objects | | `limit` | int | Limit of objects retrieved per page | | `page` | int | Number of the retrieved page | | `is_last_page`| boolean| Information indicating whether the retrieved page is the last | ### Issuance Serie {#issuance_serie} | Field | Type | Description | | ----------------------------- | ------ | ----------------------------------------------------- | | issuance_serie_key | string | Unique key of the issuance series | | name | string | Name of the issuance series | | subclass_name | string | Subclass name (e.g., SUBORDINADA) | | serie | int | Series number | | quota_calculation_method | string | Quota calculation method (e.g., quota_value) | | internal_code | string | Internal code of the series | | fund_class_name | string | Name of the fund class associated with the series | | fund_class_short_name | string | Short name of the fund class | | fund_class_document_number | string | CNPJ of the fund class | | minimum_share_capital | float | Minimum value for investment | | investment_category | string | Investment category (e.g., multi_market) | | payment_type | string | Payment type (e.g., transfer) | | account_data | JSON | **[Account Data](#account-data)** object | | last_updated_date | string | Last update date (YYYY-MM-DD) | | administrator | JSON | **[Administrator](#administrator)** object | | operation_periods | JSON | **[Operation Periods](#operation-periods)** object | | isin_code | string | ISIN code of the series | | condominium_type | string | `open_ended` (open) or `close_ended` (closed). Only `open_ended` series accept redemptions. | | asset_type | string | Asset type (e.g. `multi_market_fund_quota`) | | status | string | `created`, `active`, `inactive` or `pre_operational` | | financial_institution_code | string | Code of the financial institution used for automatic debit | ### Administrator | Field | Type | Description | | ------------------ | ------ | -------------------------------- | | administrator_key | string | Unique key of the administrator | | name | string | Administrator name | | document_number | string | Administrator CNPJ | | status | string | `active` or `blocked` | ### Operation Periods | Field | Type | Description | | ---------------------- | ---- | ----------------------------------------------------------------------------------------------- | | redemption_request | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for redemptions | | amortization_request | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for amortizations | | financial_application | JSON | **[Quotation and Payment](#quotation-and-payment)** periods object for applications | ### Quotation and Payment | Field | Type | Description | | -------------- | ------ | ------------------------------------------------ | | days | int | Number of days | | type | string | Counting type (e.g., fixed, until) | | calendar_base | string | Calendar base (e.g., workdays, calendar_365) | ### Account Data | Field | Type | Description | | ---------------------------- | ------ | --------------------------------------------------------------------------- | | account_digit | string | Bank account digit | | account_branch | string | Bank branch number | | account_number | string | Bank account number | | financial_institution_code | string | Financial institution code | | financial_institution_ispb | string | Financial institution ISPB (Brazilian Payment System) | ## Errors | Status | Code | When it happens | | ------ | ----------- | ---------------------------------------------------------------- | | 404 | `TFQ000002` | The integration's manager is not registered on the platform. | Authentication, permission and host errors: see [API Errors](/documentation/iaas/introducao/erros). --- # Fund Quota Position Query URL: /en/documentation/iaas/cotas_de_fundo/consulta_posicoes_cotas_de_fundo Returns, for each invested fund, **how much your fund has invested**: the updated position value in reais, the number of quotas and the date of the latest mark-to-market. Unlike the financial application query, which lists operation by operation, here the response is already consolidated by issuance series of the invested fund. This is the query to use to find out the balance invested in a **cash sweep fund** — see [Querying the position in a cash sweep fund](#fundo-de-zeragem). :::info Available on | Profile | Host | Required permission | | ------- | ------------- | ------------------- | | Manager | `manager-api` | Read | Base URL for each host: [Environments (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /wallet/fund_class/FUND_CLASS_KEY/fund_quota_positions METHOD GET Where `FUND_CLASS_KEY` is the key of **your** fund class, the one that holds the quotas. ### Query Params | Parameter | Type | Description | Required | | --------------------- | ------ | -------------------------------------------------------------------------------------------- | -------- | | `page` | int | Page number. Starts at `0`. Default: `0`. | No | | `limit` | int | Number of records per page. Maximum: `50`. Default: `10`. | No | | `document_number` | string | CNPJ of the invested fund class, with punctuation. Exact match. | No | | `internal_code` | string | Internal code of the invested series. Partial match. | No | | `internal_codes` | list | List of internal codes. Exact match. | No | | `fund_class_name` | string | Name of the invested fund class. Partial match. | No | | `subclass_name` | list | Seniority of the invested subclass: `senior`, `mezzanine`, `subordinate`. | No | | `investment_category` | list | Category of the invested fund: `fidc`, `fiagro`, `multi_market`, `fixed_income`, `private_equity`, `equity`, `real_state`. | No | | `asset_types` | list | Asset type: `fidc_fund_quota`, `fiagro_fund_quota`, `multi_market_fund_quota`, `fixed_income_fund_quota`, `private_equity_fund_quota`. | No | ```python title="Request example" GET /wallet/fund_class/{fund_class_key}/fund_quota_positions?document_number=11.222.333/0001-81 ``` :::info Attention Only positions in **active** assets are included in the result. Fully redeemed or written-off quotas do not appear. ::: ## Response STATUS 200 ```json title='Response Body' { "data": [ { "quota_fund_class": { "name": "Série Única", "quota_fund_class_key": "UUID", "document_number": "00.000.000/0000-00", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class Short Name", "investment_category": "fixed_income", "tax_classification": "long_term", "internal_code": "Internal Code", "subclass_name": "senior", "entity_category": "fund", "fund_term_target": "undetermined", "fund_regime": "open_ended", "operation_periods": { "redemption_request": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } }, "isin_code": "BR000000000" }, "total_current_value": 1234567.89, "total_current_units": 1180000.0, "last_mtm_date": "YYYY-MM-DD", "lag": { "reference": "daily", "amount": 1 } } ], "limit": 10, "page": 0, "is_last_page": true } ``` ### Response Fields | Field | Type | Description | | -------------- | ------- | ---------------------------------------------------------------- | | `data` | array | List of **[Position](#posicao)** objects | | `limit` | int | Limit of objects retrieved per page | | `page` | int | Retrieved page number | | `is_last_page` | boolean | Indicates whether the retrieved page is the last one | ### Position {#posicao} | Field | Type | Description | | --------------------- | ------ | ------------------------------------------------------------------------------------------------ | | `quota_fund_class` | JSON | **[Invested fund](#fundo-investido)** object | | `total_current_value` | float | **Updated position value, in reais.** Sum of the current value of the series' assets | | `total_current_units` | float | Current number of quotas held in the series | | `last_mtm_date` | string | **Oldest** mark-to-market date among the aggregated positions, in `YYYY-MM-DD` format | | `lag` | JSON | Pricing lag configuration of the series. Omitted when the series has no lag | :::caution **Attention** Unlike the Cash Visibility API, where balances come in cents, here `total_current_value` is a decimal number in reais. E.g.: `1234.56` = R$ 1,234.56. `last_mtm_date` is the **minimum** among the mark-to-market dates of the aggregated positions, not the most recent one. Use it to know up to which date the value is guaranteed to be up to date. ::: ### Invested fund {#fundo-investido} | Field | Type | Description | | ------------------------ | ------ | ------------------------------------------------------------------------ | | `name` | string | Name of the invested issuance series | | `quota_fund_class_key` | string | Unique key of the invested issuance series | | `document_number` | string | CNPJ of the invested fund class | | `fund_class_name` | string | Name of the invested fund class | | `fund_class_short_name` | string | Short name of the invested fund class | | `investment_category` | string | Investment category of the invested fund | | `tax_classification` | string | Tax classification of the invested fund | | `internal_code` | string | Internal code of the invested series | | `subclass_name` | string | Seniority of the invested subclass | | `entity_category` | string | Category of the invested entity | | `fund_term_target` | string | Target term of the invested fund | | `fund_regime` | string | Regime of the invested fund | | `operation_periods` | JSON | Quotation and settlement periods for the series' operations | | `isin_code` | string | ISIN code of the series. Omitted when the series has no registered ISIN | ## Querying the position in a cash sweep fund {#fundo-de-zeragem} Cash sweep funds are liquidity funds used to invest your fund class's idle cash, with application and redemption by automatic debit. The operation is performed through the [Create Financial Application](/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras) and [Create Redemption Request](/documentation/iaas/cotas_de_fundo/operacao_resgates) endpoints, sending the `source_account_key`. To query how much your fund class has invested in a specific cash sweep fund, filter by its CNPJ (replace `11.222.333/0001-81` with the cash sweep fund's CNPJ): ```python title="Position in a cash sweep fund" GET /wallet/fund_class/{fund_class_key}/fund_quota_positions?document_number=11.222.333/0001-81 ``` The `total_current_value` in the response is the invested balance, in reais, as of the date indicated by `last_mtm_date`. :::info Attention The same invested fund class may have more than one issuance series. In that case the response returns **one row per series**, all with the same `document_number`, and the total balance in the fund is the sum of the returned `total_current_value` values. ::: To know the balance in the **bank account** — the cash not yet invested — use the [Cash Visibility](/documentation/iaas/visibildade_de_caixa/get_accounts) endpoints. ## Errors | Status | Code | When it happens | | ------ | ----------- | ------------------------------------------------------------ | | 403 | `WLT000098` | The fund class does not belong to the integration's manager. | | 404 | `WLT000001` | Fund class not found. | | 404 | `WLT000066` | Manager not found. | Authentication, permission and host errors: see [API Errors](/documentation/iaas/introducao/erros). --- # Introduction URL: /en/documentation/iaas/cotas_de_fundo/inicio The Fund Shares system is a solution that allows the purchase, sale, and consultation related to shares of other funds. This module offers essential functionalities for: - Managing contributions and redemptions in other funds - Creating operations This documentation provides a detailed overview of how to use the fund shares system, including its main features and flows. Here you will find information about: - Purchase, sale, and consultation related to shares of other funds - Endpoints and payloads To start using the system, navigate through the topics available in this documentation to better understand each aspect of the fund shares module. --- # Create Financial Application URL: /en/documentation/iaas/cotas_de_fundo/operacao_aplicacoes_financeiras Creates an application by your fund class in quotas of another fund (invested issuance series) and lets you approve or cancel the application while it has not yet been processed. :::info Available on | Profile | Host | Required permission | | ---------- | ---------------- | ------------------------------------ | | Manager | `manager-api` | Write | | Consultant | `consultant-api` | Create Applications and Redemptions | Base URL for each host: [Environments (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application METHOD POST STATUS 201 `FUND_CLASS_KEY` is the key of **your** fund class, the one making the application. ```json title='Request Body' { "issuance_serie_key": "", "amount": 100000.00, "quotation_date": "2026-10-08", "payment_method": "wire_transfer" } ``` ### Body params | Field | Type | Description | Required | | -------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | `issuance_serie_key` | string | Key of the invested issuance series (36 characters). See [Paginated issuance series query](/documentation/iaas/cotas_de_fundo/consulta_paginada_series_de_emissao). | Yes | | `amount` | number | Application amount, greater than zero and greater than or equal to the series' `minimum_share_capital`. | Yes | | `quotation_date` | string | Quotation date (`YYYY-MM-DD`). Required when the series has `quota_calculation_method` = `quota_value`; cannot be earlier than your class's accounting date. In `internal` series it is ignored; the quotation date is set by the platform and returned in the response. | Conditional | | `source_account_key` | string | `account_key` of your class's account that will be debited. Required when the series has `payment_type` = `automatic_debit`; do not send it otherwise. | Conditional | | `payment_method` | string | `wire_transfer` (default) or `pix`. | No | :::info Automatic debit When the series has `payment_type` = `automatic_debit` (usually cash sweep funds), send `source_account_key`: the account must be open and belong to the same financial institution as the series (`financial_institution_code`). Retrieve the key in [Retrieving account information](/documentation/iaas/visibildade_de_caixa/get_accounts). ::: In `quota_value` series, the application starts in `pending_manager_approval` and must be approved (section below). In `internal` series, it is approved on creation and moves to `pending_payment`. ## Response The same object is returned by creation, approval and cancellation. Response Body ```json { "amount": 100000.0, "financial_application_key": "", "asset_key": null, "status": "pending_manager_approval", "quotation_date": "2026-10-08", "payment_date": "2026-10-08", "external_financial_application_key": null, "payment_method": "wire_transfer", "payment_type": "transfer", "issuance_serie": { "issuance_serie_key": "", "name": "Invested Issuance Serie Name", "subclass_name": "Invested Sub Class Name", "serie": 1, "quota_calculation_method": "quota_value", "condominium_type": "open_ended", "internal_code": "Internal Code", "fund_class_name": "Invested Fund Class Name", "fund_class_short_name": "Invested Fund Class Short Name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "multi_market", "asset_type": "multi_market_fund_quota", "payment_type": "transfer", "status": "active", "financial_institution_code": "329", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "2026-10-07", "administrator": { "administrator_key": "", "name": "Administrator Name", "document_number": "00.000.000/0000-00", "status": "active" }, "operation_periods": { "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } }, "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } } }, "isin_code": "BR000000000" }, "fund_class": { "fund_class_key": "", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "2026-10-07", "investor_key": "", "distributor": { "name": "Distributor Name", "distributor_key": "", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ``` `asset_key` is filled in at quotation; `iof_amount` and `number_of_quotas` appear once calculated. Each field is described in [Paginated applications query](/documentation/iaas/cotas_de_fundo/consulta_paginada_aplicacoes_financeiras#financial_application). Possible statuses: `created`, `pending_manager_approval`, `pending_distributor_approval`, `pending_external_approval`, `pending_payment`, `pending_payment_confirmation`, `pending_notify_distributor`, `pending_quotation`, `mismatched_external_data`, `canceled`, `confirmed`. ## Approve financial application Approves an application in `pending_manager_approval`. The response returns `pending_payment` or, when the series requires distributor approval, `pending_distributor_approval`. ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY METHOD PUT STATUS 202 ```json title='Request Body' { "status": "pending_payment" } ``` | Field | Type | Description | Required | | -------- | ------ | ------------------------------------------------------------------------------------------------- | -------- | | `status` | string | Send `pending_payment`. Any other value, or an application not in `pending_manager_approval`, returns `TFQ000052`. | Yes | The response is the financial application object (see [Response](#response)). ## Cancel financial application ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY/cancel METHOD PUT STATUS 202 No body. The application can be canceled in the `pending_manager_approval`, `pending_payment`, `pending_payment_confirmation` and `mismatched_external_data` statuses. In `pending_distributor_approval` and `pending_external_approval`, only the administrator can cancel (`TFQ000053`); in any other status, the API returns `TFQ000073`. The response is the financial application object, with `status` = `canceled`. ## Errors | Status | Code | When it happens | | ------ | ----------- | ---------------------------------------------------------------------------------------- | | 400 | `TFQ000023` | `amount` lower than the series' minimum application (`minimum_share_capital`). | | 400 | `TFQ000033` | The invested series belongs to your own fund class. | | 400 | `TFQ000039` | `quotation_date` not sent for a `quota_value` series. | | 400 | `TFQ000050` | `quotation_date` earlier than your class's accounting date. | | 400 | `TFQ000055` | A field required by the series is missing (for example, `source_account_key` for automatic debit). | | 400 | `TFQ000056` | `source_account_key` sent for a series that does not use automatic debit. | | 400 | `TFQ000058` | The `source_account_key` account does not belong to the series' financial institution. | | 400 | `TFQ000061` | The `source_account_key` account is not open. | | 400 | `TFQ000108` | Application sent after the series' cutoff time. | | 400 | `TFQ000148` | The issuance series is inactive. | | 400 | `TFQ000187` | The payment date calculated for the `quotation_date` has already passed. | | 400 | `TFQ000207` | The series' movement window has already closed. | | 422 | `TFQ000198` | The series is blocked for applications because the administrator is blocked. | | 422 | `TFQ000220` | The invested fund has been liquidated and does not accept new applications in this series. | | 400 | `TFQ000052` | Approval with a `status` other than `pending_payment`, or application not in `pending_manager_approval`. | | 400 | `TFQ000053` | Cancellation of an application awaiting the distributor or the administrator. | | 400 | `TFQ000073` | Cancellation not allowed in the current status. | | 403 | `TFQ000054` | The fund class does not belong to your manager, or approval of an application in `pending_external_approval` (only the administrator approves it). | | 404 | `TFQ000005` | Fund class not found. | | 404 | `TFQ000011` | Issuance series not found. | | 404 | `TFQ000013` | Financial application not found (cancellation). | | 404 | `TFQ000059` | Financial application not found (approval). | Authentication, permission and host errors: see [API Errors](/documentation/iaas/introducao/erros). --- # Create Redemption Request URL: /en/documentation/iaas/cotas_de_fundo/operacao_resgates Creates a redemption request for the quotas your fund class holds in another fund (invested issuance series) and lets you approve or cancel the request. :::info Available on | Profile | Host | Required permission | | ---------- | ---------------- | ------------------------------------ | | Manager | `manager-api` | Write | | Consultant | `consultant-api` | Create Applications and Redemptions | Base URL for each host: [Environments (Hosts)](/documentation/iaas/introducao/inicio#ambientes-hosts). ::: ## Request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request METHOD POST STATUS 201 `FUND_CLASS_KEY` is the key of **your** fund class, the one that holds the quotas. ```json title='Request Body' { "issuance_serie_key": "", "external_id": "3f1c2a9e-8b7d-4c6e-9a5f-1d2e3c4b5a60", "amount": 50000.00, "quotation_date": "2026-10-08" } ``` ### Body params | Field | Type | Description | Required | | -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | `issuance_serie_key` | string | Key of the invested issuance series (36 characters). The series must be open-ended (`open_ended`). | Yes | | `external_id` | string | Your identifier for the request, exactly 36 characters long (a UUID). Unique: a second request with the same value is refused with `TFQ000048`. | Yes | | `amount` | number | Redemption amount, greater than zero. In `internal` series it is treated as the net amount. Required when `redeem_all` is not `true`. | Conditional | | `redeem_all` | boolean | `true` to redeem the entire position; in that case `amount` is not needed. | No | | `quotation_date` | string | Quotation date (`YYYY-MM-DD`). Required when the series has `quota_calculation_method` = `quota_value`; cannot be earlier than your class's accounting date. In `internal` series it is ignored. | Conditional | | `payment_date` | string | Payment date (`YYYY-MM-DD`), equal to or later than `quotation_date`. If omitted, `quotation_date` applies. Only used in `quota_value` series. | No | | `source_account_key` | string | `account_key` of your class's account at the series' financial institution. Required when the series' `payment_type` is `automatic_debit`; do not send it when it is `transfer`. | Conditional | :::info Automatic debit When the series' `payment_type` is `automatic_debit` (usually cash sweep funds), send `source_account_key`: the account must be open and belong to the same financial institution as the series. Retrieve the key in [Retrieving account information](/documentation/iaas/visibildade_de_caixa/get_accounts). ::: :::tip Retry If an error occurs, resend the request: if the request already exists, the API returns `TFQ000048` (409) and does not create another one. In that case, check it in the [Paginated redemption query](/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates) instead of creating it again. See [Retry and duplicates](/documentation/iaas/introducao/erros#reenvio-e-duplicidade). ::: In `quota_value` series, the request starts in `pending_manager_approval` and must be approved (section below). In `internal` series, it is approved on creation. ## Response The same object is returned by creation, approval and cancellation. Response Body ```json { "redemption_request_key": "", "external_redemption_request_key": null, "status": "pending_manager_approval", "quotation_date": "2026-10-08", "payment_date": "2026-10-08", "amount": 50000.0, "issuance_serie": { "issuance_serie_key": "", "name": "Issuance Serie Name", "subclass_name": "SUBORDINADA", "serie": 1, "quota_calculation_method": "quota_value", "condominium_type": "open_ended", "internal_code": "Internal Code", "fund_class_name": "Fund Class Name", "fund_class_short_name": "Fund Class Short Name", "fund_class_document_number": "00.000.000/0000-00", "minimum_share_capital": 0.0, "investment_category": "fixed_income", "asset_type": "fixed_income_fund_quota", "payment_type": "automatic_debit", "status": "active", "financial_institution_code": "329", "account_data": { "account_digit": "0", "account_branch": "0001", "account_number": "12345", "financial_institution_code": "329", "financial_institution_ispb": "00000000" }, "last_updated_date": "2026-10-07", "administrator": { "administrator_key": "", "name": "Administrator Name", "document_number": "00.000.000/0000-00", "status": "active" }, "operation_periods": { "redemption_request": { "payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" }, "quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" } }, "financial_application": { "payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" }, "quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" } } } }, "fund_class": { "fund_class_key": "", "name": "Fund Class Name", "short_name": "Fund Class Short Name", "document_number": "00.000.000/0000-00", "accounting_date": "2026-10-07", "investor_key": "", "distributor": { "name": "Distributor Name", "distributor_key": "", "document_number": "00.000.000/0000-00" }, "manager": { "manager_key": "", "manager_name": "Manager Name", "document_number": "00.000.000/0000-00" } } } ``` `redeem_all` appears (as `true`) when the request is a full redemption; `cash_expectation` appears once the cash expectation has been created. The `external_id` you sent is not returned. Each field is described in [Paginated redemption query](/documentation/iaas/cotas_de_fundo/consulta_paginada_resgates#redemption-request). Possible statuses: `created`, `pending_manager_approval`, `pending_distributor_approval`, `pending_external_approval`, `pending_quotation`, `quoted`, `mismatched_external_data`, `canceled`, `confirmed`, `quotation_reversed`. ## Approve redemption request Approves a request in `pending_manager_approval`. No body. ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/approval METHOD PUT STATUS 202 The `PUT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY` route, with the body `{"status": "pending_external_approval"}`, performs the same approval and remains available on the same profiles. The response is the redemption request object (see [Response](#response)). ## Cancel redemption request ENDPOINT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/cancel METHOD PUT STATUS 202 No body. You can cancel the request while it is in `pending_manager_approval`. After approval, cancellation is done by the administrator, and the API returns `TFQ000053`. The response is the redemption request object, with `status` = `canceled`. ## Errors | Status | Code | When it happens | | ------ | ----------- | --------------------------------------------------------------------------------------- | | 409 | `TFQ000048` | A redemption request with this `external_id` already exists. | | 400 | `TFQ000039` | `quotation_date` not sent for a `quota_value` series. | | 400 | `TFQ000041` | Your class has no active quotas of this series to redeem. | | 400 | `TFQ000046` | `payment_date` earlier than `quotation_date`. | | 400 | `TFQ000049` | The series has no calculated quota yet (`internal` series). | | 400 | `TFQ000050` | `quotation_date` earlier than your class's accounting date. | | 400 | `TFQ000055` | `source_account_key` not sent for a series with automatic debit. | | 400 | `TFQ000056` | `source_account_key` sent for a series with `payment_type` = `transfer`. | | 400 | `TFQ000058` | The `source_account_key` account does not belong to the series' financial institution. | | 400 | `TFQ000061` | The `source_account_key` account is not open. | | 400 | `TFQ000067` | `amount` not sent and `redeem_all` other than `true`. | | 400 | `TFQ000177` | The series does not accept redemptions (closed-ended). | | 400 | `TFQ000207` | The series' movement window has already closed (approval). | | 400 | `TFQ000052` | Approval of a request not in `pending_manager_approval`. | | 400 | `TFQ000053` | Cancellation of a request not in `pending_manager_approval`. | | 403 | `TFQ000054` | The fund class does not belong to your manager. | | 404 | `TFQ000005` | Fund class not found. | | 404 | `TFQ000011` | Issuance series not found. | | 404 | `TFQ000045` | Redemption request not found (cancellation). | | 404 | `TFQ000060` | Redemption request not found (approval). | Authentication, permission and host errors: see [API Errors](/documentation/iaas/introducao/erros).