Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token smart money post volume

GET /token/{id}/smart-money-post-volume

Starter

Description

Post volume time-series from smart money (giga brain) cohort only. Note: /token/{id}/smartmoney-post-volume is a deprecated alias and will be removed after 30 days.

Path Parameters

id

stringrequired

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

Query Parameters

hours

integeroptional

Lookback window in hours.

granularity

stringoptionalenum: 1h, 2h, 4h, 12h, 1d

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

Responses

Media type: application/json

giga_brain_volume

array<object> optional

Token social post-volume series for smart-money cohort.

giga_brain_volume[].tag_breakdown

array<object> optional

Per-bucket post-tag counts for smart-money posts.

giga_brain_volume[].tag_breakdown[].count

integer (int64) optional

Smart-money posts carrying the tag in the bucket.

giga_brain_volume[].tag_breakdown[].tag

string optional

Normalized post tag.

Allowed values

technical_analysisfundamental_analysisonchainmacrofomofudshillingnews_reportproject_updatealpha_leakprediction_marketipoetflistingdelistinghackscam_warningairdropwhalebreaking_newspotential_catalystmindsharefundraisingrumourlong_callshort_call

giga_brain_volume[].time

string (date-time) optional

UTC timestamp for the data point.

giga_brain_volume[].value

number (double) optional

Numeric metric value for the timestamp.

cURL Example

curl --request GET \
  --url 'https://api.ruma.fun/api/v1/public/token/bitcoin/smart-money-post-volume' \
  --header 'X-API-Key: YOUR_API_KEY'

JSON Response

200 · application/json

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