Social API
The tokens one X (Twitter) account posted about
Tokens an X account named in its posts, newest first: chain, address, pool and pool creation time, and the post. Early or late call.
/api/external/social/social-mentioned-tokens/{username}What it returns
The tokens one X (Twitter) account named in its posts, newest post first, up to 100 a page: the token, its chain, the pool it trades in and when that pool was created, and the post itself. The pool time against the post time shows whether the account called it early or late. tokenAddress is the address exactly as spelled, or null when its spelling cannot be recovered — then tokenAddressLowercased still identifies an EVM token, but NOT a Solana one, whose addresses are case-sensitive; the same holds for the pool and paired addresses. symbol and name are lower-cased. Each mention carries its own chain; the key carries none. 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-mentioned-tokens/<username>"
| Parameter | Description |
|---|---|
pagequery · integer · optional | Which page, from 1 (the newest) to 1000. Defaults to 1. Follow nextPage for the next one. |
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 "@". |
mentions | object[] | Newest post first. |
mentions[].chain | string | null | The chain the token is on, e.g. "SOL", "ETH" or "BASE". null when not stated. |
mentions[].tokenAddress | string | null | The token address exactly as spelled. null when its spelling cannot be recovered (see the description). |
mentions[].tokenAddressLowercased | string | null | The token address lower-cased. null when not stated. |
mentions[].symbol | string | null | The token's symbol, lower-cased. null when not stated. |
mentions[].name | string | null | The token's name, lower-cased. null when not stated. |
mentions[].pairedTokenAddress | string | null | The token it is paired with in the pool (e.g. wrapped SOL), as spelled. null when not known or when its spelling cannot be recovered. |
mentions[].poolAddress | string | null | The pool address, as spelled. null when not known or when its spelling cannot be recovered. |
mentions[].poolCreatedAt | integer | null | When the pool was created, unix seconds. null when not known. |
mentions[].postId | string | null | The id of the post that named it, a decimal string. null when not stated. |
mentions[].postedAt | integer | null | When that post went up, unix seconds. null when not stated. |
mentions[].text | string | null | The post's full text, as posted. null when not stated. |
nextPage | integer | null | The 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