Social API
The newest crypto posts on X (Twitter), live
A live stream of the newest crypto posts on X across accounts, newest first: token calls and contract addresses as they appear.
/api/external/social/social-post-streamWhat it returns
The newest crypto posts seen on X (Twitter), from many accounts, newest first, each with its author id, full text and counts — new token calls, contract addresses and launches surface here first. Counts are read when the post is first seen, so they are near zero and views is often null; ask social-posts-by-id later for how a post landed. To poll, pass the newest id you hold as since and only newer posts come back; an empty list means nothing newer yet. Not scoped to any chain.
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-post-stream"
| Parameter | Description |
|---|---|
limitquery · integer · optional | How many of the newest posts to return, 1 to 100. Defaults to 50. |
sincequery · string · optional | A post id: only posts newer than it come back. Omit for the newest posts regardless. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
posts | object[] | Newest first. |
posts[].id | string | The post's id, a decimal string — the number at the end of its link. |
posts[].conversationId | string | null | The id of the post that opened its thread. null when not stated. |
posts[].authorId | string | null | The author's numeric X id, a decimal string. null when not stated. |
posts[].postedAt | integer | null | When it was posted, unix seconds. null when not stated. |
posts[].text | string | null | Its full text. A repost carries the reposted text, prefixed "RT @user:". null when empty. |
posts[].isRepost | boolean | null | Whether it is a repost of another post. null when not stated. |
posts[].isQuote | boolean | null | Whether it quotes another post. null when not stated. |
posts[].replyTo | object | null | The post it replies to. null when it is not a reply. |
posts[].replyTo.postId | string | null | The id of the post replied to. null when not stated. |
posts[].replyTo.userId | string | null | The replied-to author's numeric X id. null when not stated. |
posts[].replyTo.username | string | null | The replied-to author's username. null when not stated. |
posts[].replies | integer | null | Replies, when read. null when not stated. |
posts[].reposts | integer | null | Reposts, when read. null when not stated. |
posts[].quotes | integer | null | Quotes, when read. null when not stated. |
posts[].likes | integer | null | Likes, when read. null when not stated. |
posts[].bookmarks | integer | null | Bookmarks, when read. null when not stated. |
posts[].views | integer | null | Views, when read. null when not stated — some posts carry none. |
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