Skip to main content
GET
/
signal
/
v1
/
x-users
Get X Users
curl --request GET \
  --url https://api.messari.io/signal/v1/x-users \
  --header 'X-Messari-API-Key: <api-key>'
{
  "error": null,
  "data": [
    {
      "id": "902926941413453824",
      "name": "CZ 🔶 BNB",
      "username": "cz_binance",
      "profileImageUrl": "https://pbs.twimg.com/profile_images/1961440580279336960/PiiIs8Lh_normal.jpg",
      "isProjectAccount": false,
      "mindshare": {
        "1d": {
          "percentage": 0.034890980338150246,
          "percentageChange": 0.034890980338150246
        },
        "7d": {
          "percentage": 0.034458922464253736,
          "percentageChange": 0.034458922464253736
        },
        "30d": {
          "percentage": 0.03557571700437064,
          "percentageChange": 0.03557571700437064
        },
        "60d": {
          "percentage": 0.03629217455421106,
          "percentageChange": 0.036292174554211055
        },
        "90d": {
          "percentage": 0.0329216354708752,
          "percentageChange": 0.0329216354708752
        },
        "180d": {
          "percentage": 0.03071263471318053,
          "percentageChange": 0.03071263471318053
        },
        "1y": {
          "percentage": 0.03088932044319519,
          "percentageChange": 0.030889320443195194
        },
        "ytd": {
          "percentage": 0.029667654382160347,
          "percentageChange": 0.029667654382160347
        }
      },
      "followerMetrics": {
        "followersCount": 10382989,
        "followingCount": 1897
      },
      "postMetrics": {
        "postCount": 7315
      },
      "engagement": {
        "1d": {
          "score": 2278.207463
        },
        "7d": {
          "score": 2232.2417266449
        },
        "30d": {
          "score": 2284.523025578015
        },
        "60d": {
          "score": 1597.500120303374
        },
        "90d": {
          "score": 1387.074796083386
        },
        "180d": {
          "score": 994.992483901485
        },
        "1y": {
          "score": 1509.81573022287
        },
        "ytd": {
          "score": 1410.044721711185
        }
      }
    },
    {
      "id": "1501997405755088900",
      "name": "wale.moca 🐳",
      "username": "waleswoosh",
      "profileImageUrl": "https://pbs.twimg.com/profile_images/1700199367511064576/v-3PNyPw_normal.jpg",
      "isProjectAccount": false,
      "mindshare": {
        "1d": {
          "percentage": 0.03321820405674671,
          "percentageChange": 0.03321820405674671
        },
        "7d": {
          "percentage": 0.03272618851659199,
          "percentageChange": 0.03272618851659199
        },
        "30d": {
          "percentage": 0.03367419501591688,
          "percentageChange": 0.03367419501591688
        },
        "60d": {
          "percentage": 0.03485815910407686,
          "percentageChange": 0.03485815910407685
        },
        "90d": {
          "percentage": 0.031855235703700406,
          "percentageChange": 0.031855235703700406
        },
        "180d": {
          "percentage": 0.030093633685173888,
          "percentageChange": 0.030093633685173895
        },
        "1y": {
          "percentage": 0.03067172334671213,
          "percentageChange": 0.03067172334671213
        },
        "ytd": {
          "percentage": 0.029211158443947092,
          "percentageChange": 0.029211158443947092
        }
      },
      "followerMetrics": {
        "followersCount": 178814,
        "followingCount": 9120
      },
      "postMetrics": {
        "postCount": 240575
      },
      "engagement": {
        "1d": {
          "score": 373.7749508196
        },
        "7d": {
          "score": 387.314916959887
        },
        "30d": {
          "score": 421.828238155834
        },
        "60d": {
          "score": 402.102484583878
        },
        "90d": {
          "score": 374.090522946982
        },
        "180d": {
          "score": 322.547894908288
        },
        "1y": {
          "score": 297.900355189483
        },
        "ytd": {
          "score": 316.589711508614
        }
      }
    },
    {
      "id": "1375396777348698115",
      "name": "Sweep",
      "username": "0xSweep",
      "profileImageUrl": "https://pbs.twimg.com/profile_images/1971310355688079360/hW7BEdbx_normal.jpg",
      "isProjectAccount": false,
      "mindshare": {
        "1d": {
          "percentage": 0.0315196090577131,
          "percentageChange": 0.0315196090577131
        },
        "7d": {
          "percentage": 0.03115230148373319,
          "percentageChange": 0.03115230148373319
        },
        "30d": {
          "percentage": 0.032333322115732574,
          "percentageChange": 0.03233332211573257
        },
        "60d": {
          "percentage": 0.033729480805541175,
          "percentageChange": 0.03372948080554117
        },
        "90d": {
          "percentage": 0.030846393180977136,
          "percentageChange": 0.030846393180977136
        },
        "180d": {
          "percentage": 0.029041328802250365,
          "percentageChange": 0.029041328802250365
        },
        "1y": {
          "percentage": 0.029590040859025245,
          "percentageChange": 0.029590040859025248
        },
        "ytd": {
          "percentage": 0.028112406736409145,
          "percentageChange": 0.028112406736409145
        }
      },
      "followerMetrics": {
        "followersCount": 237774,
        "followingCount": 14908
      },
      "postMetrics": {
        "postCount": 866743
      },
      "engagement": {
        "1d": {
          "score": 112.039604528964
        },
        "7d": {
          "score": 122.447942506059
        },
        "30d": {
          "score": 143.773173281433
        },
        "60d": {
          "score": 140.247598030238
        },
        "90d": {
          "score": 138.217975466459
        },
        "180d": {
          "score": 122.487249623859
        },
        "1y": {
          "score": 123.397381276243
        },
        "ytd": {
          "score": 117.991778461613
        }
      }
    },
    {
      "id": "295218901",
      "name": "vitalik.eth",
      "username": "VitalikButerin",
      "profileImageUrl": "https://pbs.twimg.com/profile_images/1895872023944937472/Uoyc5-p8_normal.jpg",
      "isProjectAccount": false,
      "mindshare": {
        "1d": {
          "percentage": 0.03138387935943685,
          "percentageChange": 0.03138387935943685
        },
        "7d": {
          "percentage": 0.031175293266454924,
          "percentageChange": 0.031175293266454924
        },
        "30d": {
          "percentage": 0.03284712889366022,
          "percentageChange": 0.03284712889366022
        },
        "60d": {
          "percentage": 0.03418320227347127,
          "percentageChange": 0.03418320227347127
        },
        "90d": {
          "percentage": 0.03229046443224906,
          "percentageChange": 0.032290464432249054
        },
        "180d": {
          "percentage": 0.030860918564761204,
          "percentageChange": 0.030860918564761204
        },
        "1y": {
          "percentage": 0.029665583505766518,
          "percentageChange": 0.029665583505766518
        },
        "ytd": {
          "percentage": 0.028911748897618772,
          "percentageChange": 0.028911748897618772
        }
      },
      "followerMetrics": {
        "followersCount": 5835201,
        "followingCount": 515
      },
      "postMetrics": {
        "postCount": 21215
      },
      "engagement": {
        "1d": {
          "score": 488.43829592562
        },
        "7d": {
          "score": 429.744204739551
        },
        "30d": {
          "score": 672.635772959163
        },
        "60d": {
          "score": 574.787500622552
        },
        "90d": {
          "score": 604.083523315675
        },
        "180d": {
          "score": 621.08590532656
        },
        "1y": {
          "score": 1074.913645217297
        },
        "ytd": {
          "score": 771.701882779501
        }
      }
    },
    {
      "id": "376457303",
      "name": "THΞGABO🍌",
      "username": "thegaboeth",
      "profileImageUrl": "https://pbs.twimg.com/profile_images/1965129416515747840/-7XCXI6o_normal.jpg",
      "isProjectAccount": false,
      "mindshare": {
        "1d": {
          "percentage": 0.030017305643890116,
          "percentageChange": 0.030017305643890116
        },
        "7d": {
          "percentage": 0.029595273676447632,
          "percentageChange": 0.029595273676447632
        },
        "30d": {
          "percentage": 0.030250209991534736,
          "percentageChange": 0.030250209991534733
        },
        "60d": {
          "percentage": 0.031046395842298805,
          "percentageChange": 0.03104639584229881
        },
        "90d": {
          "percentage": 0.028986120319099806,
          "percentageChange": 0.0289861203190998
        },
        "180d": {
          "percentage": 0.027821272249558177,
          "percentageChange": 0.027821272249558174
        },
        "1y": {
          "percentage": 0.028651660968411614,
          "percentageChange": 0.028651660968411614
        },
        "ytd": {
          "percentage": 0.027266987189946367,
          "percentageChange": 0.027266987189946367
        }
      },
      "followerMetrics": {
        "followersCount": 93873,
        "followingCount": 30293
      },
      "postMetrics": {
        "postCount": 503252
      },
      "engagement": {
        "1d": {
          "score": 176.550447251902
        },
        "7d": {
          "score": 184.156443445606
        },
        "30d": {
          "score": 180.424703522342
        },
        "60d": {
          "score": 165.781439343636
        },
        "90d": {
          "score": 160.507504556738
        },
        "180d": {
          "score": 126.254514869435
        },
        "1y": {
          "score": 113.759103063505
        },
        "ytd": {
          "score": 117.34738747782
        }
      }
    }
  ],
  "metadata": {
    "pageSize": 10,
    "page": 1,
    "totalRows": 20469,
    "totalPages": 2047
  }
}

Authorizations

​
X-Messari-API-Key
string
header
required

Query Parameters

​
limit
integer
default:10

Number of items per page

Example:

10

​
pageSize
integer

Number of items per page. Kept for backward compatibility

​
page
integer
default:1

Page number

Example:

1

​
sort
enum<string>

Desired sort order of X users

Available options:
mindshare,
mindshare.1d.mindshare,
mindshare.7d.mindshare,
mindshare.30d.mindshare,
mindshare.60d.mindshare,
mindshare.90d.mindshare,
mindshare.180d.mindshare,
mindshare.1y.mindshare,
mindshare.ytd.mindshare,
mindshare.1d.percentageChange,
mindshare.7d.percentageChange,
mindshare.30d.percentageChange,
mindshare.60d.percentageChange,
mindshare.90d.percentageChange,
mindshare.180d.percentageChange,
mindshare.1y.percentageChange,
mindshare.ytd.percentageChange,
engagement,
engagement.1d.score,
engagement.7d.score,
engagement.30d.score,
engagement.60d.score,
engagement.90d.score,
engagement.180d.score,
engagement.1y.score,
engagement.ytd.score,
followers,
followerMetrics.followersCount,
followerMetrics.followingCount,
postMetrics.postCount
​
sortDirection
string

Desired sort direction of X users

​
accountType
enum<string>
Available options:
project,
individual

Response

Default response

​
data
object[]
required
​
error
string
​
metadata
object