Paginated query of secondary market trades

A paginated query endpoint that returns the quota trades in the secondary market of a fund class. Each record represents the transfer of a number of quotas from a selling quotaholder to a buying quotaholder, with the quota value applied in the trade and the taxation withheld from the seller.

Each trade relates three financial applications:

Role	Description
sold_financial_application	Application of the seller, from which the quotas came out. It is the one the fund class, series, investor and central depositary filters are applied to.
new_financial_application	Application created for the buyer, with financial_application_type equal to secondary_market.
original_financial_application	Application that originated the position in the primary market. In successive resales, the same original application is propagated to all the trades of the chain, allowing the original entry of the quotas to be traced.

Request

ENDPOINT

/quota/fund_class/{fund_class_key}/secondary_market_trades

METHOD

GET

Query params

Parameter	Type	Required	Description
page	integer	optional	Page number (starts at 0). Default: 0.
limit	integer	optional	Number of records per page. Default: 50. Maximum: 500.
issuance_serie_key	string	optional	Filters by the trades of the provided issuance series.
investor_key	string	optional	Filters by the trades in which the provided investor is the seller.
sold_financial_application_key	string	optional	Filters by the financial application the traded quotas came from.
central_depositary	string	optional	Filters by the central depositary of the source application. Values: cetip (quotas deposited at B3) or unregistered (quotas not deposited).

The records are returned in chronological order of the creation of the trade.

Example call

GET /quota/fund_class/{fund_class_key}/secondary_market_trades?page=0&limit=50&issuance_serie_key=c3d4e5f6-a7b8-9012-cdef-123456789012&central_depositary=cetip

Response

STATUS

200

Response Body

{
  "data": [
    {
      "secondary_market_trade_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "original_financial_application": {
        "financial_application_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "share_capital": 500000.0,
        "status": "quoted",
        "redemption_keys": [
          {
            "redemption_key": "c3d4e5f6-a7b8-9012-cdef-123456789012"
          }
        ],
        "financial_application_type": "primary_market",
        "original_number_of_quotas": 500000.0,
        "current_principal_value": 490000.0,
        "acquisition_cost": 500000.0,
        "current_number_of_quotas": 490000.0,
        "quotation_date": "2026-03-02",
        "payment_method": "b3",
        "investor_key": "d4e5f6a7-b8c9-0123-def0-234567890123",
        "issuance_serie_key": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "external_id": "ext-fa-001"
      },
      "sold_financial_application": {
        "financial_application_key": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "share_capital": 500000.0,
        "status": "quoted",
        "redemption_keys": [
          {
            "redemption_key": "c3d4e5f6-a7b8-9012-cdef-123456789012"
          }
        ],
        "financial_application_type": "primary_market",
        "original_number_of_quotas": 500000.0,
        "current_principal_value": 490000.0,
        "acquisition_cost": 500000.0,
        "current_number_of_quotas": 490000.0,
        "quotation_date": "2026-03-02",
        "payment_method": "b3",
        "investor_key": "d4e5f6a7-b8c9-0123-def0-234567890123",
        "issuance_serie_key": "e5f6a7b8-c9d0-1234-ef01-345678901234",
        "external_id": "ext-fa-001"
      },
      "new_financial_application": {
        "financial_application_key": "f6a7b8c9-d0e1-2345-f012-456789012345",
        "share_capital": 10523.45,
        "status": "quoted",
        "redemption_keys": [],
        "financial_application_type": "secondary_market",
        "original_number_of_quotas": 10000.0,
        "current_principal_value": 1.05234567,
        "acquisition_cost": 1.05234567,
        "current_number_of_quotas": 10000.0,
        "quotation_date": "2026-03-02",
        "payment_method": "b3",
        "investor_key": "a7b8c9d0-e1f2-3456-0123-567890123456",
        "issuance_serie_key": "e5f6a7b8-c9d0-1234-ef01-345678901234"
      },
      "trade_quota_value": 1.05234567,
      "number_of_quotas": 10000.0,
      "event_datetime": "2026-07-31 00:00:00",
      "taxable_yield_value": 523.45,
      "ir_value": 78.52,
      "iof_value": 0.0
    }
  ],
  "limit": 50,
  "page": 0,
  "is_last_page": true
}

Response attributes

Field	Type	Description
data	array	List of trades of the fund class.
page	integer	Current page.
limit	integer	Requested page size.
is_last_page	boolean	Indicates whether there are no more records after this page.

Object in data

Field	Type	Description
secondary_market_trade_key	string	Unique key of the trade.
original_financial_application	object	Financial application that originated the position in the primary market.
sold_financial_application	object	Financial application of the seller, from which the quotas came out.
new_financial_application	object	Financial application created for the buyer.
trade_quota_value	number	Quota value applied in the trade.
number_of_quotas	number	Number of quotas traded.
event_datetime	string	Date and time of the trade event.
taxable_yield_value	number	Taxable yield computed for the seller in the trade. Omitted when not computed.
ir_value	number	Income tax withheld from the seller. Omitted when not computed.
iof_value	number	IOF withheld from the seller. Omitted when not computed.

Financial application object

Field	Type	Description
financial_application_key	string	Unique key of the financial application.
share_capital	number	Value contributed to the application.
status	string	Situation of the application, for example quoted, settled, redeemed.
redemption_keys	array	Keys of the redemptions associated with the application. In the seller's application it includes the redemption generated by the trade.
financial_application_type	string	primary_market or secondary_market.
original_number_of_quotas	number	Number of quotas at the creation of the application.
current_number_of_quotas	number	Current number of quotas.
current_principal_value	number	Current principal value.
acquisition_cost	number	Acquisition cost.
quotation_date	string	Quotation date.
payment_method	string	Settlement method, for example b3 or regular.
investor_key	string	Key of the investor who holds the application.
issuance_serie_key	string	Key of the issuance series of the application.
external_id	string	External identifier, when provided in the registration of the application.

Optional fields are omitted from the response when there is no value.

To query the financial applications in detail, see Paginated query of financial applications.

Possible errors

STATUS

404

Fund class not found

{
  "title": " Fund Class not Found",
  "description": "Fund Class with key {fund_class_key} was not found.",
  "translation": "A classe com chave {fund_class_key} não foi encontrado.",
  "code": "QTA000002"
}

STATUS

400

Fund class does not belong to the authenticated manager

The query only returns trades of fund classes whose manager is the holder of the integration used in the call.

{
  "title": "Invalid selected agent",
  "description": "Invalid selected agent",
  "translation": "Selected agent invalido",
  "code": "QIT000004"
}