Skip to main content
GET
List assets
asset_type identifies the asset, such as ETH. One asset can have several acquisition records.

Authorizations

X-API-Key
string
header
required

Your organization API key. See Authentication.

Query Parameters

asset_ids
string[]

Exact asset IDs. Combine with other filters to narrow the result.

Required array length: 1 - 100 elements

Asset ID returned by this API.

sort_by
enum<string>

Sort field.

Available options:
date_received,
asset_type,
quantity,
cost_basis,
created_at
sort_direction
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Filter by one or more legal entity IDs. Omit to include all authorized entities. An empty list is invalid.

ledger_account_ids
string[]

Prefixed ledger account IDs (lac_). Up to 100 IDs.

asset_types
string[]

Filter by asset type (such as ETH, BTC).

chains
string[]

Filter by blockchain chain.

start_date
string

Filter assets received on or after this date (ISO 8601).

end_date
string

Filter assets received on or before this date (ISO 8601).

limit
integer
default:50

Maximum number of records to return.

Required range: 1 <= x <= 100
cursor
string

The next_cursor value from the previous page. Keep the other filters unchanged.

expand
enum<string>

Add the existing full asset valuation for each selected row. Omit to keep the current response and avoid pricing work. Canonical lot quantities, basis and timestamps do not change.

Available options:
valuation
selected_date
string<date>

Valuation date. Requires expand=valuation. This does not change acquisition-date filters.

accounting_period_id
string

Owned period for valuation. Requires expand=valuation. A period outside the current month uses its end date; otherwise selected_date or the current time applies.

Response

The request succeeded.

data
object[]
required

The records.

has_more
boolean
required

Whether another page is available.

next_cursor
string | null
required

Cursor for the next page, or null on the last page.