# Token post volume

- Method: `GET`
- Path: `/token/{id}/post-volume`
- Tier: Basic
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-token-id-post-volume/
- Interactive docs: https://docs.hiddensystems.ai/nebula/#endpoint=get-token-id-post-volume

## Description

Post volume time-series for the token (all authors).

## cURL Example

```bash
curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/post-volume' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Path Parameters

- `id` (string, required): Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

## Query Parameters

- `hours` (integer, optional): Lookback window in hours.
- `granularity` (string, optional): Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

## Response

OK

- `post_volume` (array<object>): Token social post-volume series (all tracked authors).
- `post_volume[].tag_breakdown` (array<object>): Per-bucket post-tag counts.
- `post_volume[].tag_breakdown[].count` (integer (int64)): Posts carrying the tag in the bucket.
- `post_volume[].tag_breakdown[].tag` (string, enum: technical_analysis, fundamental_analysis, onchain, macro, fomo, fud, shilling, news_report, project_update, alpha_leak, prediction_market, ipo, etf, listing, delisting, hack, scam_warning, airdrop, whale, breaking_news, potential_catalyst, mindshare, fundraising, rumour, long_call, short_call): Normalized post tag.
- `post_volume[].time` (string (date-time)): UTC timestamp for the data point.
- `post_volume[].value` (number (double)): Numeric metric value for the timestamp.

Media type: `application/json`

## JSON Response

```json
{
  "post_volume": [
    {
      "tag_breakdown": [
        {
          "count": 0,
          "tag": "technical_analysis"
        }
      ],
      "time": "2026-01-15T12:00:00Z",
      "value": 0
    }
  ]
}
```