Skip to main content
GET
/
signal
/
v1
/
x-users
/
time-series
/
{granularity}
Get X Users timeseries data
curl --request GET \
  --url https://api.messari.io/signal/v1/x-users/time-series/{granularity} \
  --header 'X-Messari-API-Key: <api-key>'
{
  "error": null,
  "data": [
    {
      "id": "973261472",
      "name": "Ansem",
      "username": "blknoiz06",
      "points": [
        {
          "time": 1748736000,
          "mindshare": {
            "rank": 564,
            "percentage": 0.02552740632461845
          },
          "followerMetrics": {
            "followersCount": 735833,
            "followingCount": 8334
          }
        },
        {
          "time": 1748822400,
          "mindshare": {
            "rank": 613,
            "percentage": 0.025102979029792177
          },
          "followerMetrics": {
            "followersCount": 736811,
            "followingCount": 8334
          }
        },
        {
          "time": 1748908800,
          "mindshare": {
            "rank": 529,
            "percentage": 0.025333428012604024
          },
          "followerMetrics": {
            "followersCount": 737611,
            "followingCount": 8340
          }
        },
        {
          "time": 1748995200,
          "mindshare": {
            "rank": 458,
            "percentage": 0.02556520957664605
          },
          "followerMetrics": {
            "followersCount": 738042,
            "followingCount": 8341
          }
        },
        {
          "time": 1749081600,
          "mindshare": {
            "rank": 466,
            "percentage": 0.02577839727111603
          },
          "followerMetrics": {
            "followersCount": 738782,
            "followingCount": 8339
          }
        }
      ]
    },
    {
      "id": "902926941413453824",
      "name": "CZ 🔶 BNB",
      "username": "cz_binance",
      "points": [
        {
          "time": 1748736000,
          "mindshare": {
            "rank": 13,
            "percentage": 0.027719740178415574
          },
          "followerMetrics": {
            "followersCount": 10125881,
            "followingCount": 1833
          }
        },
        {
          "time": 1748822400,
          "mindshare": {
            "rank": 13,
            "percentage": 0.027394331906940513
          },
          "followerMetrics": {
            "followersCount": 10125273,
            "followingCount": 1833
          }
        },
        {
          "time": 1748908800,
          "mindshare": {
            "rank": 18,
            "percentage": 0.027325523586691196
          },
          "followerMetrics": {
            "followersCount": 10117923,
            "followingCount": 1834
          }
        },
        {
          "time": 1748995200,
          "mindshare": {
            "rank": 21,
            "percentage": 0.027360345383071277
          },
          "followerMetrics": {
            "followersCount": 10113978,
            "followingCount": 1833
          }
        },
        {
          "time": 1749081600,
          "mindshare": {
            "rank": 15,
            "percentage": 0.027685152892575633
          },
          "followerMetrics": {
            "followersCount": 10113076,
            "followingCount": 1833
          }
        }
      ]
    }
  ]
}

Authorizations

X-Messari-API-Key
string
header
required

Path Parameters

granularity
enum<string>
default:1d
required

Time interval for data aggregation. Valid values: 1h (hourly), 6h (6-hour), 1d (daily)

Available options:
1h,
6h,
1d
Example:

"1d"

Query Parameters

start
string
default:2025-06-01T00:00:00Z

Time range start. Encoded as RFC3339 or unix timestamp.

Example:

"2025-06-01T00:00:00Z"

end
string
default:2025-06-07T00:00:00Z

Time range end. Encoded as RFC3339 or unix timestamp.

Example:

"2025-06-07T00:00:00Z"

xUserIDs
string
default:@blknoiz06,@cz_binance
required

X User IDs

Example:

"@blknoiz06,@cz_binance"

Response

Default response

data
object[]
required
error
string