All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Token

Token post volume

GET /token/{id}/post-volume
GetTokenIdPostVolume

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

Parameters

id string PATH required

Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

Example:bitcoin

hours integer QUERY

Lookback window in hours.

Example:168

granularity string QUERY

Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

Allowed values
1h2h4h12h1d

Example:1h

cURL Example

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

Responses

200 OK
400 Bad Request ErrorResponse

Media type application/json

post_volume
array<object> optional

Token social post-volume series (all tracked authors).
post_volume[].tag_breakdown
array<object> optional

Per-bucket post-tag counts.
post_volume[].tag_breakdown[].count
integer (int64) optional

Posts carrying the tag in the bucket.

post_volume[].tag_breakdown[].tag
string optional

Normalized post tag.

Allowed values
technical_analysisfundamental_analysisonchainmacrofomofudshillingnews_reportproject_updatealpha_leakprediction_marketipoetflistingdelistinghackscam_warningairdropwhalebreaking_newspotential_catalystmindsharefundraisingrumourlong_callshort_call
post_volume[].time
string (date-time) optional

UTC timestamp for the data point.

post_volume[].value
number (double) optional

Numeric metric value for the timestamp.

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