Portfolios

List cost-basis lot ledger entries

Returns a paginated cost-basis lot ledger for a portfolio. Supports AIP-160 filter strings and optional legacy assetRef. Response rows include diff as the signed lot quantity.

get/v1/portfolios/{portfolioSlug}/cost-basis-lots

Request

  • Base URL: https://api.tokenbooks.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.tokenbooks.io/v1/portfolios/{portfolioSlug}/cost-basis-lots
  • Auth: API key in header x-api-key

Path parameters

portfolioSlugstring required

Workspace-scoped portfolio slug

Query parameters

pageinteger

Page number

pageSizeinteger

Items per page (max 100)

chainIdstring
walletAddressstring

Wallet address

entryKindstring[]

Comma-separated lot entry kinds (ADD, DSP, CUT, MVE, RES, REL)

string date-time
OR
string
string date-time
OR
string
filterstring

AIP-160 style filter. Supported fields: id lot identifier (=, !=, in, not in), entry_id ledger-row identifier (=, !=, in, not in), asset_id (=, !=, in, not in), asset_spam (= true or false), entry_kind (=, !=, in, not in), wallet (=, !=, in, not in using chainId:address), portfolio_transaction_id (=, !=, in, not in), timestamp (=, !=, >, >=, <, <= with ISO datetimes). The asset display name is not filterable.

assetRefstring

Deprecated compatibility selector for asset symbol or asset id. Prefer filter=asset_id.

sortstring

Single sort field: timestamp, diff, value, price. Prefix with - for descending.

Response

Changes

No recorded changes to this operation across all 1 revision of this API.