---
title: "Addresses in Loss by Age"
method: GET
path: "/v1/metrics/breakdowns/addresses_loss_count_by_age"
---

# Addresses in Loss by Age

`GET /v1/metrics/breakdowns/addresses_loss_count_by_age`

## Request

- Base URL: `https://api.glassnode.com`
- URL: `https://api.glassnode.com/v1/metrics/breakdowns/addresses_loss_count_by_age`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/glassnode/apis/glassnode-api-addresses/docs/v1/metrics/breakdowns/addresses_loss_count_by_age/get.ts> (a function with typed inputs; its response is checked against the schema)

**Definition.** The number of unique addresses currently in loss, segmented by holding-period age cohort. An address is in loss when the current price is below its average acquisition price. Cohorts span from hot addresses (coins acquired more recently) to cold addresses (older, dormant coins).\n\n**Technical.** Breakdown metrics use an address-based approach, analyzing transactions and holdings at the individual wallet-address level to facilitate comparability across digital assets and to ensure consistent analysis across blockchain architectures. This contrasts with the UTXO-based approach used for chains like Bitcoin, where unspent transaction outputs are analyzed to categorize asset properties. Metrics for UTXO-based assets may show slight deviations when compared across these methods.\n

[View in Studio](https://studio.glassnode.com/charts/breakdowns.AddressesLossCountByAge?a=USDT)

## Query parameters

- `a` string, required
- `s` integer
- `u` integer
- `i` string
- `f` 'csv' | 'json'
- `timestamp_format` 'unix' | 'humanized'

## Response `200`

Successful response

- TimeSeriesDataPoint[]
  - `t` integer: Unix timestamp
  - `v` union: Metric value (can be number, object, or array depending on the metric)
    - number
    - object
  - `o` object: Object containing multiple metric values (when applicable)

## Other responses

- `400`: Bad Request - Invalid parameters or unsupported asset
- `401`: Unauthorized - Invalid or missing API key
- `429`: Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/glassnode/apis/glassnode-api-addresses.md) - [All operations](https://skmtc.dev/glassnode/apis/glassnode-api-addresses/llms.txt) - [OpenAPI document](https://skmtc.dev/glassnode/apis/glassnode-api-addresses/revisions/7f6a24031f46?raw)