Holdings
Returns live token holdings for a DYLI username or wallet address.
Use this for portfolios, holder lookups, ownership summaries, or collector profiles. Each returned holding includes estimated value fields when DYLI has pricing for that token.
curl "https://www.dyli.io/api/public/v1/holdings/alex" \
-H "x-api-key: $DYLI_API_KEY"
curl "https://www.dyli.io/api/public/v1/holdings/0xBC6026Af0c12526Bf8c6E90aF0cE7F14707fEee0?includeTotals=true" \
-H "x-api-key: $DYLI_API_KEY"
identifier can be a DYLI username, @username, or an EVM wallet address. When you pass a username, DYLI resolves the active wallet for that user before reading token holdings.
Query Parameters
| Name | Description |
|---|---|
pageSize | Number of token rows to return. Max is 100. Alias: limit. |
cursor | Cursor for the next page. Use pagination.next_cursor from the previous response. |
includeTotals | Set true to scan the wallet and return total token and balance counts. Alias: include_totals. |
includeValue | Set true to scan the full wallet and return collection_value. Alias: include_value. This is heavier than a normal page request. |
Value Fields
Returned rows include:
| Field | Description |
|---|---|
value.estimated_unit_usd | Estimated value for one unit of the token. |
value.estimated_total_usd | Estimated value for the held balance of that token. |
value.source | Pricing source used, such as DYLI floor, FMV, Alt FMV, or primary price. |
estimated_value_usd | Shortcut for value.estimated_total_usd. |
The response summary includes summary.returned_value for the current page. Pass includeValue=true when you need full collection_value.
Values are estimates from available pricing data, not bids or guaranteed liquidation values.