跳到主要内容

获取公开份额

按参考日期返回各发行系列已批准且公开的份额价值。这是公开查询：无需 API 密钥，也无需对请求签名。

适用范围
角色主机所需权限
公开api.qidtvm.com.br无（无需 API 密钥）

公开主机仅服务于生产环境。各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/public_dash/mark_to_market/fund_quota/mark_to_markets
MÉTODO
GET
STATUS
200

Query Params​

参数类型描述
internal_codeslist发行系列内部代码列表（以逗号分隔，或重复传入该参数）
from_reference_datestring查询周期起始日期（YYYY-MM-DD）
to_reference_datestring查询周期结束日期（YYYY-MM-DD）
internal_codestring要查询的发行系列唯一代码
fund_class_document_numberstring要查询的基金 CNPJ（含标点）
limitint每页条目数：1 至 400（默认 10）
pageint页码，从 0 开始（默认 0）

仅返回状态为已批准且标记为公开的份额价值。

注意

份额价值位于**发行系列（issuance_serie）**层面，因此使用 fund_class_document_number 参数将返回所有系列。 建议仅将此过滤器用于映射发行系列的唯一标识符（internal_code 和 issuance_serie_key）。

Response​

响应体
{
   "data": [
      {
         "issuance_serie_key": "1de4125b-48c7-40ca-b97b-0b65fb356468",
         "internal_code": "INTERNAL-CODE-2",
         "fund_class_document_number": "11.222.333/0001-81",
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "marks_to_market": [
            {
               "reference_date": "2025-09-05",
               "before_amortization_unit_price": 1000,
               "unit_price": 1000
            }
         ]
      },
      {
         "issuance_serie_key": "71f7ee44-388d-4916-b068-647e82fd67c8",
         "internal_code": "INTERNAL-CODE-1",
         "fund_class_document_number": "11.222.333/0001-81",
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "marks_to_market": [
            {
               "reference_date": "2025-09-04",
               "before_amortization_unit_price": 1000,
               "unit_price": 1000
            }
         ]
      }
   ],
   "limit": 5,
   "page": 0,
   "is_last_page": true
}

Issuance Serie​

字段类型描述
issuance_serie_keystring发行系列标识键
internal_codestring内部标识发行系列的代码
fund_class_document_numberstring所查询投资基金的 CNPJ
fund_class_namestring所查询投资基金的名称
marks_to_marketarrayMarks To Market 对象列表

Marks To Market​

字段类型描述
reference_datestring发行系列份额价值日期（YYYY-MM-DD）
before_amortization_unit_pricefloat摊销前的发行系列份额价值
unit_pricefloat结算后的发行系列份额价值

错误​

状态代码发生情形
400—limit 超出 1 至 400 范围、page 为负数，或日期格式无效

认证、权限和主机相关错误：参见 API 错误。