Social API

Whom one X (Twitter) account follows

The accounts an X account follows, newest follows first, each with profile, counts, category and influence score.

GET/api/external/social/social-following/{username}

What it returns

The accounts one X (Twitter) account follows, the most recently seen follows first, up to 500 a page — each with its profile, counts, category and influence score. What a known trader or fund started following lately is often a project before it is announced. Follow nextPage for more. Not scoped to any chain. A username no tracked account has answers 404.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/social/social-following/<username>"
Parameters
ParameterDescription
page

query · integer · optional

Which page, from 1 (the newest) to 1000. Defaults to 1. Follow nextPage for the next one.
username

path · string · required

An X (Twitter) account by its username, with or without the leading "@" (e.g. "solana"), in any case — 1 to 15 letters, digits or underscores. Not a wallet address, and not scoped to any chain.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Whom one X (Twitter) account follows
FieldTypeDescription
usernamestringThe username asked about, without "@".
accountsobject[]The most recently seen follows first.
accounts[].usernamestring | nullThe username, without "@", as the account spells it. null when not stated.
accounts[].userIdstring | nullThe account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated.
accounts[].displayNamestring | nullThe account's display name. null when not stated.
accounts[].biostring | nullThe account's bio. null when empty or not stated.
accounts[].locationstring | nullThe location the account states. null when empty or not stated.
accounts[].websitestring | nullThe website the account links. null when empty or not stated.
accounts[].followersinteger | nullHow many accounts follow it. null when not stated.
accounts[].followinginteger | nullHow many accounts it follows. null when not stated.
accounts[].postsinteger | nullHow many posts it has made, reposts and replies included. null when not stated.
accounts[].createdAtinteger | nullWhen the account was created, unix seconds. null when not known.
accounts[].observedAtinteger | nullWhen these figures were read, unix seconds. null when not stated.
accounts[].categorystring | nullWhat kind of account it is, e.g. "Crypto Project" or "Crypto Person" — as social-account-category publishes it. null when not classified.
accounts[].scorenumber | nullIts influence among crypto accounts, as social-account-score publishes it: open-ended, higher = more influential. null when not scored.
nextPageinteger | nullThe page to ask for next. null on the last page.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key