Cost Basis

GET /v2/accounts/{account_id}/cost-basis/

This endpoint allows users to retrieve the most recent cost basis for positions within a given account.

Cost Basis Headers

Authorization required	The access token.

Cost Basis Parameters

account_id string, required	ID of the account.
page integer	Desired page number, default is 0.
page_size integer	Desired number of entries per page, defaults is 100, max value is 1000.

Cost Basis Response Object Fields

id string, required	The ID of the tax lot.
cusip string, required	CUSIP Identifier
symbol string, required	Symbol
description string	Security description
quantity number, required	The cost basis quantity for the tax lot.
market_value number	The total value of the tax lot.
cost_basis_unadjusted number	Unadjusted Cost Basis
cost_basis_adjusted number	Adjusted Cost Basis
unrealized_gain_loss number	Gain or loss not yet realized.
as_of_date string, required	Date of the record.
open_date string, required	The open date of the lot.

GET /api/v1/cost-basis/{account_id} (deprecating soon)

This endpoint returns the most recent cost basis for the given account.

Cost Basis Headers

Authorization required	The access token.
X-API-Request-ID string	The household-provided request ID.

Cost Basis Parameters

account_id string, required	ID of the account.
page integer	Desired page number, default is 0.
page_size integer	Desired number of entries per page, defaults is 100, max value is 1000.

Cost Basis Response Object Fields

id string, required	The ID of the tax lot.
cusip string, required	CUSIP Identifier
symbol string, required	Symbol
description string	Security Description
quantity number, required	The cost basis quantity for the tax lot.
market_value number	The total value of the tax lot.
cost_basis_unadjusted number	Unadjusted Cost Basis.
cost_basis_adjusted number	Adjusted Cost Basis.
unrealized_gain_loss number	Gain or loss not yet realized.
as_of_date string, required	Date of the record.
open_date string, required	The open date of the lot.