> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset Buybacks

> Tokens a project buys back and burns, summed over rolling 5-minute, 1-hour and 24-hour windows, in USD and in the token. Each series is one asset, keyed by its asset id. A point is published every 5 minutes and is final once published: time is the end of each window, and a point appears about 20 minutes after it, once every minute in its windows has settled. Each window carries a status: ok, empty when nothing was burned, partial when some minutes have no USD price, or stale when source data is missing and the values are null.

| | |
| - | - |
| Access | Token-buybacks-dataset |
| Timeseries model | `asset-buybacks`: intervals `5m`, series key `id` (Asset ID), series must be named (up to 20 per call) |

## Endpoints

> **[Batch Get Asset timeseries](https://docs.blockworks.com/api-reference/data-api/token-buybacks/timeseries-asset-buybacks.md)**
>
> Up to 20 series in one request, named by Asset ID in `series`.

> **[Get Asset timeseries](https://docs.blockworks.com/api-reference/data-api/token-buybacks/timeseries-asset-buybacks-by-id.md)**
>
> One series over a time window, keyed by its Asset ID.

## Metrics

10 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `seq` | Sequence | int64 | | Minutes since 1970-01-01 UTC at time. Increases by 5 from one point to the next. |
| `buyback5mUSD` | Buyback 5m (USD) | float64 | usd | USD value of tokens bought back and burned in the 5 minutes before time. Null when status5m is stale. |
| `buyback5mNative` | Buyback 5m (Native) | float64 | native-token | Tokens bought back and burned in the 5 minutes before time. Null when status5m is stale. |
| `status5m` | Status 5m | string | | ok, empty (nothing burned), partial (some minutes have no USD price, so the USD value sums the priced minutes only) or stale (source data missing, values null). |
| `buyback1hUSD` | Buyback 1h (USD) | float64 | usd | USD value of tokens bought back and burned in the hour before time. Null when status1h is stale. |
| `buyback1hNative` | Buyback 1h (Native) | float64 | native-token | Tokens bought back and burned in the hour before time. Null when status1h is stale. |
| `status1h` | Status 1h | string | | ok, empty (nothing burned), partial (some minutes have no USD price, so the USD value sums the priced minutes only) or stale (source data missing, values null). |
| `buyback24hUSD` | Buyback 24h (USD) | float64 | usd | USD value of tokens bought back and burned in the 24 hours before time. Null when status24h is stale. |
| `buyback24hNative` | Buyback 24h (Native) | float64 | native-token | Tokens bought back and burned in the 24 hours before time. Null when status24h is stale. |
| `status24h` | Status 24h | string | | ok, empty (nothing burned), partial (some minutes have no USD price, so the USD value sums the priced minutes only) or stale (source data missing, values null). |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/asset-buybacks/5m/1e31218a-e44e-4285-820c-8282ee222035?timeframe=7d&selections=seq,buyback5mUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Asset timeseries](https://docs.blockworks.com/api-reference/data-api/token-buybacks/timeseries-asset-buybacks-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.