Skip to main content
POST
Retrieve portfolio transactions for a date range.

Authorizations

Authorization
string
header
required

OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header

Body

JSON request with non-empty PortfolioName, optional unambiguous PortfolioType, StartDate, EndDate, optional Counterparties, and IncludeZeroQuantities. A default start date has no effective lower bound; provide an end date for a meaningful result. Date ordering is not explicitly constrained.

Portfolio, date window, counterparty filter, and zero-quantity choice used to retrieve a transaction table.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Positions.ApiGetTransactionTableRequest, Derivitec.Web.Core
portfolio_name
string | null

Name of the portfolio to select. The value must not be null or empty.

Example:

"Example portfolio"

portfolio_type
enum<string> | null

Portfolio category used to resolve the requested portfolio. It may be omitted when the portfolio name resolves unambiguously.

Available options:
derivitec,
enfusion,
orchestrade,
liquidity_book,
maia,
fund_studio,
not_set
counterparties
string[] | null

Optional counterparty names that restrict the returned rows.

end_date
string<date-time>

Inclusive final calendar date, evaluated at end of day in the caller's time zone.

include_zero_quantities
boolean

Whether to retain positions whose quantities net to zero; defaults to false.

start_date
string<date-time>

Initial calendar date; its default value applies no effective lower date bound.

Response

Returns the transaction data table, or an unsuccessful payload when the portfolio is unavailable to the caller.

Tabular portfolio positions or transactions produced by a position-table query.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.Positions.ApiGetTransactionTableResponse, Derivitec.Web.Core
is_success
boolean

Whether the operation completed successfully. The default is true; error outcomes set it to false.

Example:

true

error_messages
string[] | null

Messages explaining operation-level failures. The collection is empty by default.

data_table
object[] | null

JSON row table using the caller's organisation-specific columns and grouping when configured.