跳到主要内容

获取发行信息


以分页方式列出某基金类别的份额发行。

适用范围
角色主机所需权限
管理人manager-api读取

各主机的 Base URL:环境(主机)。

Request​

ENDPOINT
/quota_offering_control/fund_class/FUND_CLASS_KEY/quota_offerings
MÉTODO
GET
STATUS
200

Query Params​

参数描述
limit每页条目数。默认 50,最大 500
page页码,从 0 开始。默认 0
sub_class_key子类别唯一标识键
issuance_serie_key发行系列唯一标识键
showOffersactive:仅返回有剩余金额的有效发行。closed:已关闭或已过到期日的发行

Responses​

案例 01:有发行的基金
{
"data":[
{
"quota_offering_key":"UUID",
"status":"active",
"original_quota_offering_value":0.00,
"issued_number_of_quotas":0.00000000,
"remaining_quota_offering_value":0.00,
"start_date":"YYYY-MM-DD",
"issuance_serie":{
"name":"1",
"issuance_serie_key":"UUID",
"sub_class":{
"name":"SÊNIOR",
"sub_class_key":"UUID",
"subordination_level":1,
"fund_class":{
"fund_class_key":"UUID",
"name":"SAMPLE FUND CLASS NAME",
"document_number":"00.000.000/0000-00",
"short_name":"SAMPLE FUND CLASS SHORT NAME"
}
},
"classification":"general / qualified / professional",
"market_type":"primary / secondary"
},
"type":"public / private",
"subscription_note_template_key":"UUID",
"subscription_note_generation_type":"internal / external",
"regulatory_type":"exclusive_fund",
"cvm_registration":{
"date":"YYYY-MM-DD",
"number":"AAA/BBB/CCC/DDD/EEE/YYYY/000"
},
"lead_coordinator":{
"name":"SAMPLE LEAD COORDINATOR NAME",
"address":{
"uf":"SP",
"city":"São Paulo",
"number":"0000",
"street":"Sample street name",
"complement":"Sample complement"
},
"document_number":"00.000.000/0000-00"
},
"status_events":[
{
"status":"active",
"event_datetime":"YYYY-MM-DD HH:MM:SS"
}
]
}
],
"limit":50,
"page":0,
"is_last_page":true
}
案例 02:没有发行的基金
{
"data":[],
"limit":50,
"page":0,
"is_last_page":true
}

Response Fields​

字段类型描述
dataarrayQuota Offering 对象列表
limitint每页返回的对象数量上限
pageint返回的页码
is_last_pageboolean表示返回的页面是否为最后一页

Quota Offering​

字段类型描述
quota_offering_keystring发行唯一标识键
statusstringcreated / active / processing_closing / pending_closing_at_cvm / pending_closing_at_anbima / pending_divulgation / closed
subscription_note_generation_typestringinternal(文件由 QI 生成)/ external
subscription_note_template_keystring认购公告模板键
regulatory_typestring发行的监管类型
status_eventsarray状态历史(status、event_datetime)
original_quota_offering_valuefloat发行原始金额
issued_number_of_quotasfloat已认购份额数量
remaining_quota_offering_valuefloat发行剩余金额
start_datestring发行起始日期
issuance_seriestringIssuance Serie 对象
typestring公开/私募发行类型
cvm_registrationJSONCVM 登记数据。未填写时不返回
lead_coordinatorJSON牵头协调人数据。未填写时不返回
maturity_datestring到期日期。未填写时不返回
original_number_of_quotasfloat原始份额数量。未填写时不返回
cvm_registration
{
"date":"YYYY-MM-DD",
"number":"AAA/BBB/CCC/DDD/EEE/YYYY/000"
}
lead_coordinator
{
"name":"SAMPLE LEAD COORDINATOR NAME",
"address":{
"uf":"SP",
"city":"São Paulo",
"number":"0000",
"street":"Sample street name",
"complement":"Sample complement"
},
"document_number":"00.000.000/0000-00"
}

Issuance Serie​

字段类型描述
namestring发行系列名称
issuance_serie_keystring发行系列唯一标识键
sub_classJSONSub Class 对象
classificationstring专业 / 合格 / 普通
market_typestring一级 / 二级
serieinteger发行系列在子类别内的顺序编号(1、2、3……),同一子类别内不重复

Sub Class​

字段类型描述
namestring子类别名称
sub_class_keystring子类别唯一标识键
subordination_levelint子类别从属级别
fund_classJSONFund Class 对象

Fund Class​

字段类型描述
namestring基金类别名称
fund_class_keystring基金类别唯一标识键
document_numberstring基金类别 CNPJ
short_namestring基金类别简称

错误​

状态代码发生情形
400QIT000004该基金类别不由该管理人管理
404QOF000007未找到基金类别

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