Public Securities Recorder

Request

ENDPOINT

/trade_treasury/public/fund_class/{fund_class_key}/operation

METHOD

POST

Path params

Parameter	Type	Description
fund_class_key	string	Unique identifier for the fund.

Request Body

{
    "external_id": "a3f1c2e4-7b8d-4e6f-9a0b-1c2d3e4f5a6b",
    "operation_date": "2025-12-04",
    "payment_date": "2025-12-04",
    "operation_part": "assignee",
    "operation_type": "outright_operation",
    "counterparty": {
        "iselic_number": "20824264",
        "selic_account_number": "123456789",
        "document_number": "20.824.264/0001-77"
    },
    "treasury_type": "ntn_b",
    "unit_price": 1234.567891,
    "units": 10,
    "maturity_date": "2035-05-15"
}

Body attributes

Field	Type	Required	Description
external_id	string	optional	External identifier for idempotency (UUID). Auto-generated if not provided. Maximum 36 characters.
operation_date	string (date)	required	Operation date in YYYY-MM-DD format. Must be a business day and equal to the fund's accounting_date.
payment_date	string (date)	required	Settlement date in YYYY-MM-DD format. Must be >= operation_date. For non-term operations (outright_operation, buyback_operation), must equal operation_date.
operation_part	string	required	Fund's role: assignee (buyer) or assignor (seller).
operation_type	string	required	Operation type: outright_operation, buyback_operation. buyback_operation requires operation_part == "assignee".
counterparty	object	required	Counterparty data. See object below.
treasury_type	string	required	Security type: lft, ltn, ntn_b, or ntn_f.
unit_price	number	required	Unit price. Accepts any decimal precision; the server truncates down based on type: buyback_operation → 8 decimal places; others → 6 decimal places.
units	integer	required	Number of securities (positive integer).
maturity_date	string (date)	required	Security maturity date (YYYY-MM-DD). Must be strictly after operation_date.
yearly_negotiated_rate	number	conditional	Annual negotiated rate (%). Required for buyback_operation.
return_date	string (date)	conditional	Return date (YYYY-MM-DD). Required for buyback_operation. Must be > operation_date.

counterparty object

Field	Type	Required	Description
iselic_number	string	required	Counterparty iSELIC number (8 digits).
selic_account_number	string	required	Counterparty SELIC account number (9 digits).
document_number	string	required	Counterparty CNPJ with punctuation (format XX.XXX.XXX/XXXX-XX).

Response

STATUS

201

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": "EXAMPLE FUND DTVM",
        "document_number": "81.692.758/0001-30",
        "accounting_date": "2025-12-04"
    },
    "status": "pending_manager_approval",
    "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": "20824264",
        "document_number": "20.824.264/0001-77",
        "selic_account_number": "123456789"
    },
    "isin_code": "BRSTNCNTB633",
    "issue_date": "2025-11-04",
    "operation_data": {}
}

Response attributes

Field	Type	Description
operation_key	string	Unique operation identifier generated by QI Tech (UUID).
external_id	string	External identifier provided or auto-generated.
fund_class	object	Data of the fund associated with the operation.
status	string	Initial operation status.
operation_part	string	assignee (buyer) or assignor (seller).
operation_type	object	{ enumerator, code } — operation type and corresponding SELIC code.
treasury	object	{ enumerator, code } — security type and corresponding SELIC code.
operation_date	string	Operation date (YYYY-MM-DD).
payment_date	string	Settlement date (YYYY-MM-DD).
maturity_date	string	Security maturity date (YYYY-MM-DD).
total_operation_value	decimal	Total operation value (units × unit_price).
units	integer	Number of securities.
unit_price	number	Unit price of the security.
counterparty	object	Counterparty data (iselic_number, document_number, selic_account_number).
isin_code	string	Security ISIN code.
issue_date	string	Security issue date (YYYY-MM-DD).
operation_data	object	Additional internal operation metadata.