跳到主要内容

公共债券查询

按 operation_key 返回一张公共债券交易单及其状态历史。可用于跟踪交易的审批、在 SELIC 中的登记以及结算。

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

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/trade_treasury/fund_class/{fund_class_key}/operation/{operation_key}
MÉTODO
GET

Path params​

参数类型描述
fund_class_keystring基金的唯一标识。
operation_keystring创建交易单时返回的交易标识。

Response​

STATUS
200
Response Body
{
    "operation_key": "85cfd700-54a4-40f4-bc61-2ece992864ea",
    "external_id": "a3f1c2e4-7b8d-4e6f-9a0b-1c2d3e4f5a6b",
    "fund_class": {
        "fund_class_key": "5122bf31-660a-4f61-a447-38e5e17162dd",
        "manager_key": "bea7581a-f901-4995-a486-46e18ae61aab",
        "name": "FUNDO EXEMPLO DTVM",
        "document_number": "11.222.333/0001-81",
        "accounting_date": "2025-12-04",
        "internal_transfer_for_main_account": false
    },
    "status": "pending_registration",
    "operation_part": "assignee",
    "operation_type": {
        "enumerator": "outright_operation",
        "code": 1052
    },
    "treasury": {
        "enumerator": "ntn_b",
        "code": 760199
    },
    "operation_date": "2025-12-04",
    "payment_date": "2025-12-04",
    "maturity_date": "2035-05-15",
    "total_operation_value": 12345.67,
    "units": 10,
    "unit_price": 1234.567891,
    "counterparty": {
        "iselic_number": "33444555",
        "document_number": "33.444.555/0001-81",
        "selic_account_number": "123456789"
    },
    "isin_code": "BRSTNCNTB633",
    "issue_date": "2025-11-04",
    "operation_data": {},
    "status_events": [
        {
            "status": "pending_manager_approval",
            "metadata": {},
            "datetime": "2025-12-04 13:10:00.000000"
        },
        {
            "status": "pending_registration",
            "metadata": {},
            "datetime": "2025-12-04 13:25:00.000000"
        }
    ]
}

响应属性​

字段与创建交易单时相同，另外还有：

字段类型描述
statusstring当前状态。参见交易状态。
status_eventsarray状态历史，包含每次变更的 status、metadata 和 datetime。
selic_operation_id、selic_specification_id、selic_command_numberstring在 SELIC 中的标识。登记后返回。
yearly_negotiated_rate、return_date、return_unit_price、total_return_valuenumber / string返售数据。在 buyback_operation 中返回。
time_exception_reasonstring时间豁免理由（如有）。
time_exception_released_atstringQI Tech 在截止时间之后放行该交易单的日期和时间。

错误​

状态码代码触发条件
404TTR000013该基金中不存在使用此 operation_key 的交易。
404TTR000004该 fund_class_key 不存在。
403TTR000040该基金不属于您的管理人。

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