Paginated query of secondary market trades

Paginated query endpoint that returns the secondary market quota trades 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 used in the trade and the tax withheld from the seller.

Each trade relates three financial applications:

Role	Description
sold_financial_application	Seller's application, from which the quotas left. It is through it that the fund class, series, investor and central depositary filters are applied.
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 trades in the chain, making it possible to trace the original entry of the quotas.

Available on

Profile	Host	Required permission
Manager	manager-api	Read

Base URL for each host: Environments (Hosts).

Request

ENDPOINT

/quota/fund_class/{fund_class_key}/secondary_market_trades

METHOD

GET

Query params

Parameter	Type	Requirement	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 given issuance series.
investor_key	string	optional	Filters by the trades in which the given investor is the seller.
sold_financial_application_key	string	optional	Filters by the source financial application of the traded quotas.
central_depositary	string	optional	Filters by the central depositary of the source application. Values: cetip (quotas deposited at B3) or unregistered (quotas not deposited).

Records are returned in chronological order of trade creation.

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 the fund class's trades.
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	Seller's financial application, from which the quotas left.
new_financial_application	object	Financial application created for the buyer.
trade_quota_value	number	Quota value used in the trade.
number_of_quotas	number	Number of traded quotas.
event_datetime	string	Date and time of the trade event.
taxable_yield_value	number	Taxable yield determined for the seller in the trade. Omitted when not determined.
ir_value	number	Income tax withheld from the seller. Omitted when not determined.
iof_value	number	IOF withheld from the seller. Omitted when not determined.

Financial application object

Field	Type	Description
financial_application_key	string	Unique key of the financial application.
share_capital	number	Amount invested in the application.
status	string	Application status, for example quoted, settled, redeemed.
redemption_keys	array	Keys of the redemptions associated with the application. On 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 when the application was created.
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 holding the application.
issuance_serie_key	string	Key of the application's issuance series.
external_id	string	External identifier, when provided in the application registration.

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.

Errors

Status	Code	When it happens
400	QIT000004	The fund does not belong to the integration's manager
404	QTA000002	Fund class not found

Authentication, permission and host errors: see API Errors.