Social API
The usernames one X (Twitter) account has gone by
The past usernames of an X account, with when each was last seen: recycled handles and rebrands.
/api/external/social/social-username-history/{username}What it returns
The usernames one X (Twitter) account has gone by, each with the last time the account was seen under it, most recent first. A renamed account — a recycled handle, a rebranded project — shows more than one. lastSeenAt is NOT when the name was taken or the account created. 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-username-history/<username>"
| Parameter | Description |
|---|---|
usernamepath · 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.
| Field | Type | Description |
|---|---|---|
username | string | The username asked about, without "@". |
usernames | object[] | Most recently seen first. |
usernames[].username | string | null | A username the account went by. null when not stated. |
usernames[].lastSeenAt | integer | null | The last time the account was seen under this username, unix seconds. null when not stated. |
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