跳到主要内容

国债交易单

国债交易单​

Request​

ENDPOINT
/trade_treasury/fund_class/FUND_CLASS_KEY/operation
MÉTODO
POST

Request Body​

STATUS
200
Request Body
{
    "operation_date": "YYYY-MM-DD",
    "payment_date": "YYYY-MM-DD",
    "operation_part": "assignee | assignor",
    "operation_type": "buyback_operation | outright_operation | term_outright_operation",
    "counterparty":{
        "iselic_number": "00000000",
        "selic_account_number": "000000000",
        "document_number": "12.345.678/0001-10"
    },
    "treasury_type": "lft | ltn | ntn_b | ntn_f",
    "unit_price": 100,
    "units": 10,
    "maturity_date": "YYYY-MM-DD"
}
Response Body
{
    "operation_key": "85cfd700-54a4-40f4-bc61-2ece992864ea",
    "fund_class": {
        "fund_class_key": "5122bf31-660a-4f61-a447-38e5e17162dd",
        "manager_key": "bea7581a-f901-4995-a486-46e18ae61aab",
        "name": "FUNDO TESTE",
        "document_number": "81.692.758/0001-30",
        "accounting_date": "2025-12-04"
    },
    "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": "2026-12-04",
    "total_operation_value": 110,
    "units": 10,
    "unit_price": 1.10,
    "counterparty": {
        "iselic_number": "20824264",
        "document_number":"20.824.264/0001-77",
        "selic_account_number":"123456789"
    },
    "isin_code": "BRSTNCNTB633",
    "issue_date": "2025-11-04",
    "operation_data": {
        "units": 10,
        "unit_price": 1.10,
        "counterparty":{
            "iselic_number":"20824264",
            "document_number":"20.824.264/0001-77",
            "selic_account_number":"123456789"
        },
        "payment_date": "2025-12-04",
        "maturity_date": "2026-12-04",
        "treasury_type":"ntn_b",
        "operation_date":"2025-12-04",
        "operation_part":"assignee",
        "operation_type":""
    },
}

Body params​

字段类型描述字符数
operation_date *date操作日期（YYYY-MM-DD）-
payment_date *date付款日期（YYYY-MM-DD）-
operation_part *string买入（受让方/Assignee）或卖出（转让方/Assignor）枚举值
operation_type *string操作类型枚举值
counterparty *object交易对手信息-
treasury_type *string国债类型（LFT、LTN、NTN-B、NTN-F）枚举值
unit_price *number单价最多2位小数
units *number单位数量整数
maturity_date *date国债到期日（YYYY-MM-DD）-

Counterparty 对象​

字段类型描述字符数
iselic_number *stringIselic 编号8位数字
selic_account_number *stringSelic 账户9位数字
document_number *string带标点的文件编号（CNPJ）18位数字

operation_part 枚举​

字段描述
assignee受让方
assignor转让方

operation_type 枚举​

字段描述
buyback_operation回购操作
outright_operation直接操作
term_outright_operation定期直接操作

treasury_type 枚举​

字段描述
lft国库金融票据
ltn国家国库票据
ntn_b国家国库债券 B 系列
ntn_f国家国库债券 F 系列