Setup Guide
Choose your preferred platform to receive your customized Bark news feed
Open the Feed
Navigate to the News page to view your feed
Customize Your Feed
Configure what you want to track on the Settings page
Find the Bark Bot
Open @BarkFeedBot in Telegram
Connect Your Account
Use the following command to connect the bot to your Bark account:
/login <your api key>You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Configure Settings
Use /twitter track/untrack, /wallet track/untrack, etc. to configure what to track.
You can also configure settings on the Settings page
Important
Run /setup Command
In your Discord server, run the /setup command to:
- Activate your subscription
- Configure who can manage the feed settings
Configure Settings
Use /twitter track/untrack, /wallet track/untrack, etc. to configure what to track.
You can also configure settings on the Settings page
Configure WebSocket Connection
In Tree Terminal, go to Settings → News and set the following fields:
wss://news.bark.gg/wslogin <your api key>You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Add Your API Key
In PvP Terminal, go to Settings → News API and fill in your API key for "Bark News"
You can find your API key on the Account page
Enable the News Feed
Go to Scrapers → Bark News and enable:
- Feed
- Notifications
- Audio
Customize Your Feed
Configure what you want to track on the Settings page
Add Your API Key
In Tuleep Terminal, go to Settings → News trading and add your API key in the section
You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Add Your API Key
In Tealstreet Terminal, go to Settings → News Trading → Bark.gg API key and fill in your API key
You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Connect to WebSocket
Establish a WebSocket connection to the following URL:
wss://news.bark.gg/wsAuthenticate
After connecting, send the following message to authenticate:
login <your api key>You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Message Structure Overview
The main message format is designed to be compatible with trading terminals (Tree, PvP, etc.). However, all detailed, structured data is available in the tags object. This is where you should look for programmatic access to specific fields.
Base message fields:
_id- Unique identifiersource- Source systemtitle- Human-readable titlebody- Human-readable bodyurl- Primary URLicon- Icon URLimage- Image URLtime- Unix timestamp (ms)tags- Structured datainfo- Additional metadatashow_feed- Show in feedshow_notif- Show notification
Identifying Message Types
All messages include a tags.TYPE field that identifies the message type. This matches the NewsType (e.g., "TWEET", "WALLET_SWAP", "NEW_TELEGRAM_MESSAGE"). Some message types also include a tags.SUBTYPE for more specific categorization.
Common Enrichment Tags
The server automatically enriches all message types with the following tags when applicable. These are not listed per message type below to avoid repetition.
Always added (when available):
SOURCE_URL— URL to the source (from the news URL)
When CONTRACT_ADDRESS is present:
CONTRACT_ADDRESS_LABEL— How the CA was detected (e.g. "CA mentioned", "CA in bio")CONTRACT_ADDRESS_2,CONTRACT_ADDRESS_3, etc. — Additional CAs when multiple are foundPREFERRED_TRADING_URL— User's preferred trading platform URL (suffixed_2,_3for multi-CA)- SOL chain:
BULLX_URL,BULLX_NEO_URL,BULLX_LEGACY_URL,AXIOM_URL,PADRE_URL - All chains (except Hypurr/Hpump):
PHOTON_URL,MAESTRO_URL,BANANA_URL - ETH/BASE chains:
PADRE_URL - BASE chain:
SIGMA_URL,BASED_URL
When WALLET_ADDRESS is present:
WALLET_URL— Block explorer URL for the wallet
When COUNTERPARTY_ADDRESS is present:
COUNTERPARTY_URL— Block explorer URL for the counterparty
New tweets from tracked accounts, including replies, quotes, and retweets. Contains author info, tweet content, media attachments, and detected contract addresses.
How to identify: tags.TYPE === "TWEET" && tags.SUBTYPE === "NEW_TWEET"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TWEET" |
| SUBTYPE | Event type | "NEW_TWEET" |
| AUTHOR_ID | Twitter user ID | "24809221" |
| AUTHOR_HANDLE | Twitter username | "kaiynne" |
| AUTHOR_NAME | Display name | "kain.crates" |
| AUTHOR_ICON | Profile picture URL | "https://pbs.twimg.com/..." |
| TWEET_ID | Tweet ID | "2013337305461989526" |
| TWEET_TEXT | Tweet content (null for RTs) | "We did this airdrop..." |
| TWEET_TEXT_TRANSLATED | Translation if non-English | "... [Translated]" |
| TWEET_LINK | URL to tweet | "https://x.com/kaiynne/status/..." |
| SOURCE_URL | URL to the source (same as TWEET_LINK) | "https://x.com/..." |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Attached image URLs (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| VIDEO / VIDEO2 / VIDEO3 / VIDEO4 | Video URLs if present | "https://video.twimg.com/..." |
| VIDEO_THUMBNAIL / VIDEO_THUMBNAIL2 / VIDEO_THUMBNAIL3 | Thumbnails for videos | "https://pbs.twimg.com/..." |
| LINK_PREVIEW_TITLE | Title from URL embed (OpenGraph) | "Stock market today: Dow soars 1,000 points" |
| LINK_PREVIEW_DESCRIPTION | Description from URL embed (OpenGraph) | "Stocks turned sharply higher on Tuesday..." |
| LINK_PREVIEW_IMAGE | Image from URL embed (OpenGraph) | "https://s.yimg.com/ny/api/res/..." |
| IS_REPLY | Is this a reply | "true" / "false" |
| IS_QUOTE | Is this a quote tweet | "true" / "false" |
| IS_RETWEET | Is this a retweet | "true" / "false" |
| IS_SELF_REPLY | Replying to own tweet | "true" / "false" |
| REPLY_AUTHOR_HANDLE | Username of replied-to user | "katexbt" |
| REPLY_AUTHOR_NAME | Name of replied-to user | "katexbt.hl" |
| REPLY_AUTHOR_ICON | Avatar of replied-to user | "https://pbs.twimg.com/..." |
| REPLY_TWEET_ID | ID of replied-to tweet | "2013104553449660797" |
| REPLY_TWEET_TEXT | Content of replied-to tweet | "If Infinex doesn't..." |
| REPLY_TWEET_TEXT_TRANSLATED | Translation of replied-to tweet if non-English | "... [Translated]" |
| REPLY_IMAGE | Image in replied-to tweet (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| REPLY_VIDEO | Video in replied-to tweet | "https://video.twimg.com/..." |
| REPLY_VIDEO_THUMBNAIL | Thumbnail for reply video | "https://pbs.twimg.com/..." |
| REPLY_LINK_PREVIEW_TITLE | Title from URL embed in replied-to tweet | "Article headline..." |
| REPLY_LINK_PREVIEW_DESCRIPTION | Description from URL embed in replied-to tweet | "Article summary..." |
| REPLY_LINK_PREVIEW_IMAGE | Image from URL embed in replied-to tweet | "https://..." |
| QUOTED_AUTHOR_HANDLE | Username of quoted user | "infinex" |
| QUOTED_AUTHOR_NAME | Name of quoted user | "Infinex" |
| QUOTED_AUTHOR_ICON | Avatar of quoted user | "https://pbs.twimg.com/..." |
| QUOTED_TWEET_ID | ID of quoted tweet | "2013070582989111541" |
| QUOTED_TWEET_TEXT | Content of quoted tweet | "INX Token Generation..." |
| QUOTED_TWEET_TEXT_TRANSLATED | Translation of quoted tweet if non-English | "... [Translated]" |
| QUOTED_IMAGE | Image in quoted tweet (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| QUOTED_VIDEO | Video in quoted tweet | "https://video.twimg.com/..." |
| QUOTED_VIDEO_THUMBNAIL | Thumbnail for quoted video | "https://pbs.twimg.com/..." |
| QUOTED_LINK_PREVIEW_TITLE | Title from URL embed in quoted tweet | "Article headline..." |
| QUOTED_LINK_PREVIEW_DESCRIPTION | Description from URL embed in quoted tweet | "Article summary..." |
| QUOTED_LINK_PREVIEW_IMAGE | Image from URL embed in quoted tweet | "https://..." |
| RETWEET_AUTHOR_HANDLE | Username of retweeted user | "elonmusk" |
| RETWEET_AUTHOR_NAME | Name of retweeted user | "Elon Musk" |
| RETWEET_AUTHOR_ICON | Avatar of retweeted user | "https://pbs.twimg.com/..." |
| RETWEET_AUTHOR_ID | User ID of retweeted user | "44196397" |
| RETWEET_TWEET_ID | ID of retweeted tweet | "2013070582989111541" |
| RETWEET_TWEET_TEXT | Content of retweeted tweet | "Original tweet content..." |
| RETWEET_TWEET_TEXT_TRANSLATED | Translation of retweeted tweet if non-English | "... [Translated]" |
| RETWEET_IMAGE | Image in retweeted tweet (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| RETWEET_VIDEO | Video in retweeted tweet | "https://video.twimg.com/..." |
| RETWEET_VIDEO_THUMBNAIL | Thumbnail for retweet video | "https://pbs.twimg.com/..." |
| RETWEET_LINK_PREVIEW_TITLE | Title from URL embed in retweeted tweet | "Article headline..." |
| RETWEET_LINK_PREVIEW_DESCRIPTION | Description from URL embed in retweeted tweet | "Article summary..." |
| RETWEET_LINK_PREVIEW_IMAGE | Image from URL embed in retweeted tweet | "https://..." |
| AUTHOR_FOLLOWERS_COUNT | Tweet author's follower count | "128274" |
| QUOTED_AUTHOR_FOLLOWERS_COUNT | Quoted tweet author's follower count | "500000" |
| RETWEET_AUTHOR_FOLLOWERS_COUNT | Retweeted author's follower count | "1000000" |
| REPLY_AUTHOR_FOLLOWERS_COUNT | Parent tweet author's follower count | "250000" |
| CONTRACT_ADDRESS | Detected token contract address | "8HxW9Z3YT1gXgQ...pump" |
| CHAIN | Blockchain if CA detected | "SOL" / "ETHEREUM" |
| PREFERRED_TRADING_URL | Best trading URL | "https://photon-sol.tinyastro.io/..." |
| LABEL | Account label if set | "Infinex CEO, $MEC" |
| CATEGORY | Account category | "AD_HOC" / "CUSTOM" |
| AUTHOR_BIO | Author's Twitter bio | "Building cool stuff" |
| AUTHOR_CREATED_AT | Author's account creation date | "2012-03-15T..." |
| AUTHOR_LOCATION | Author's location | "San Francisco" |
| AUTHOR_PROFILE_BANNER | Author's banner image URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_WEBSITE | Author's website | "https://example.com" |
| AUTHOR_IS_BLUE_VERIFIED | Whether the author has a blue checkmark | "true" |
| AUTHOR_VERIFIED_TYPE | Author's verification type | "Business" / "Government" |
| AUTHOR_AFFILIATE_DESCRIPTION | Author's affiliate badge description | "BAGS" |
| AUTHOR_AFFILIATE_BADGE_URL | Author's affiliate badge image URL | "https://pbs.twimg.com/..." |
| AUTHOR_AFFILIATE_URL | Author's affiliate link URL | "https://example.com" |
| AUTHOR_AFFILIATE_LABEL_TYPE | Author's affiliate label type | "BusinessLabel" |
| IS_ARTICLE | Whether the tweet is a Twitter article (long-form content) | "true" |
| REPLY_IS_ARTICLE / QUOTED_IS_ARTICLE / RETWEET_IS_ARTICLE | Whether the sub-tweet is a Twitter article | "true" |
| ARTICLE_TITLE | Article title (only when IS_ARTICLE is true) | "My Article Title" |
| ARTICLE_TEXT | Article body text (only when IS_ARTICLE is true) | "Full article content..." |
| ARTICLE_BANNER | Article cover/banner image URL (only when IS_ARTICLE is true) | "https://pbs.twimg.com/media/..." |
| ARTICLE_IMAGE2 / ARTICLE_IMAGE3 / ... / ARTICLE_IMAGEN | Additional article images beyond the banner (only when IS_ARTICLE is true) | "https://pbs.twimg.com/media/..." |
| ARTICLE_VIDEO2 / ARTICLE_VIDEO3 / ... / ARTICLE_VIDEON | Additional article videos beyond the banner (only when IS_ARTICLE is true) | "https://video.twimg.com/..." |
| REPLY_ARTICLE_TITLE / QUOTED_ARTICLE_TITLE / RETWEET_ARTICLE_TITLE | Article title of sub-tweet (only when sub-tweet IS_ARTICLE is true) | "Article Title" |
| REPLY_ARTICLE_TEXT / QUOTED_ARTICLE_TEXT / RETWEET_ARTICLE_TEXT | Article body text of sub-tweet | "Full article content..." |
| REPLY_ARTICLE_BANNER / QUOTED_ARTICLE_BANNER / RETWEET_ARTICLE_BANNER | Article banner image of sub-tweet | "https://pbs.twimg.com/media/..." |
| REPLY_ARTICLE_IMAGE2..N / QUOTED_ARTICLE_IMAGE2..N / RETWEET_ARTICLE_IMAGE2..N | Additional article images of sub-tweet | "https://pbs.twimg.com/media/..." |
| REPLY_ARTICLE_VIDEO2..N / QUOTED_ARTICLE_VIDEO2..N / RETWEET_ARTICLE_VIDEO2..N | Additional article videos of sub-tweet | "https://video.twimg.com/..." |
| POLL_CHOICE1_LABEL / POLL_CHOICE2_LABEL / ... / POLL_CHOICEN_LABEL | Text label for each poll choice (set when the tweet contains a poll) | "Yes" |
| POLL_CHOICE1_VOTES / POLL_CHOICE2_VOTES / ... / POLL_CHOICEN_VOTES | Raw vote count for each poll choice | "1234" |
| POLL_CHOICE1_PERCENT / POLL_CHOICE2_PERCENT / ... / POLL_CHOICEN_PERCENT | Rounded vote share (0–100) for each poll choice. Omitted when no votes have been cast yet. | "42" |
| POLL_CHOICE1_IMAGE / POLL_CHOICE2_IMAGE / ... / POLL_CHOICEN_IMAGE | Image URL for each poll choice. Only set on image polls; text-only polls expose labels alone. | "https://pbs.twimg.com/card_img/..." |
| POLL_TOTAL_VOTES | Total votes across all choices | "4521" |
| POLL_DURATION_MINUTES | Poll duration in minutes | "1440" |
| POLL_END_AT | Poll end time as epoch milliseconds (falls back to the raw ISO string if parsing fails) | "1757946600000" |
| POLL_IS_ENDED | Set to "true" once the poll has ended and counts are final | "true" |
| REPLY_POLL_* / QUOTED_POLL_* / RETWEET_POLL_* | Same poll fields (CHOICEN_LABEL/VOTES/PERCENT/IMAGE, TOTAL_VOTES, DURATION_MINUTES, END_AT, IS_ENDED) when the sub-tweet carries a poll | "Yes" / "1234" / ... |
| AUTHOR_FOLLOWING_COUNT | Author's following count | "1018" |
| REPLY_AUTHOR_ID | User ID of replied-to user | "14355836" |
| QUOTED_AUTHOR_ID | User ID of quoted user | "19995253" |
| IS_TWITTER_SEARCH | Whether tweet was found via Twitter search | "true" |
| REPLY_TWEET_LINK | URL to the parent tweet | "https://x.com/user/status/..." |
| QUOTED_TWEET_LINK | URL to the quoted tweet | "https://x.com/user/status/..." |
| RETWEET_TWEET_LINK | URL to the retweeted tweet | "https://x.com/user/status/..." |
| REPLY_IMAGE2 / REPLY_IMAGE3 / REPLY_IMAGE4 | Additional images in replied-to tweet | "https://pbs.twimg.com/media/..." |
| REPLY_VIDEO2 / REPLY_VIDEO3 / REPLY_VIDEO4 | Additional videos in replied-to tweet | "https://video.twimg.com/..." |
| QUOTED_IMAGE2 / QUOTED_IMAGE3 / QUOTED_IMAGE4 | Additional images in quoted tweet | "https://pbs.twimg.com/media/..." |
| QUOTED_VIDEO2 / QUOTED_VIDEO3 / QUOTED_VIDEO4 | Additional videos in quoted tweet | "https://video.twimg.com/..." |
| RETWEET_IMAGE2 / RETWEET_IMAGE3 / RETWEET_IMAGE4 | Additional images in retweeted tweet | "https://pbs.twimg.com/media/..." |
| RETWEET_VIDEO2 / RETWEET_VIDEO3 / RETWEET_VIDEO4 | Additional videos in retweeted tweet | "https://video.twimg.com/..." |
| QUOTED_AUTHOR_BIO | Bio of quoted user | "Building the future" |
| QUOTED_AUTHOR_CREATED_AT | Account creation date of quoted user | "2020-01-01T..." |
| QUOTED_AUTHOR_LOCATION | Location of quoted user | "New York" |
| QUOTED_AUTHOR_PROFILE_BANNER | Banner image of quoted user | "https://pbs.twimg.com/profile_banners/..." |
| QUOTED_AUTHOR_WEBSITE | Website of quoted user | "https://example.com" |
| QUOTED_AUTHOR_IS_BLUE_VERIFIED | Whether the quoted user has a blue checkmark | "true" |
| QUOTED_AUTHOR_VERIFIED_TYPE | Quoted user's verification type | "Business" / "Government" |
| QUOTED_AUTHOR_AFFILIATE_DESCRIPTION | Quoted user's affiliate badge description | "BAGS" |
| QUOTED_AUTHOR_AFFILIATE_BADGE_URL | Quoted user's affiliate badge image URL | "https://pbs.twimg.com/..." |
| QUOTED_AUTHOR_AFFILIATE_URL | Quoted user's affiliate link URL | "https://example.com" |
| QUOTED_AUTHOR_AFFILIATE_LABEL_TYPE | Quoted user's affiliate label type | "BusinessLabel" |
| RETWEET_AUTHOR_BIO | Bio of retweeted user | "Crypto enthusiast" |
| RETWEET_AUTHOR_CREATED_AT | Account creation date of retweeted user | "2019-06-01T..." |
| RETWEET_AUTHOR_LOCATION | Location of retweeted user | "Miami" |
| RETWEET_AUTHOR_PROFILE_BANNER | Banner image of retweeted user | "https://pbs.twimg.com/profile_banners/..." |
| RETWEET_AUTHOR_WEBSITE | Website of retweeted user | "https://example.com" |
| RETWEET_AUTHOR_IS_BLUE_VERIFIED | Whether the retweeted user has a blue checkmark | "true" |
| RETWEET_AUTHOR_VERIFIED_TYPE | Retweeted user's verification type | "Business" / "Government" |
| RETWEET_AUTHOR_AFFILIATE_DESCRIPTION | Retweeted user's affiliate badge description | "BAGS" |
| RETWEET_AUTHOR_AFFILIATE_BADGE_URL | Retweeted user's affiliate badge image URL | "https://pbs.twimg.com/..." |
| RETWEET_AUTHOR_AFFILIATE_URL | Retweeted user's affiliate link URL | "https://example.com" |
| RETWEET_AUTHOR_AFFILIATE_LABEL_TYPE | Retweeted user's affiliate label type | "BusinessLabel" |
| REPLY_AUTHOR_BIO | Bio of replied-to user | "DeFi builder" |
| REPLY_AUTHOR_CREATED_AT | Account creation date of replied-to user | "2018-03-15T..." |
| REPLY_AUTHOR_LOCATION | Location of replied-to user | "London" |
| REPLY_AUTHOR_PROFILE_BANNER | Banner image of replied-to user | "https://pbs.twimg.com/profile_banners/..." |
| REPLY_AUTHOR_WEBSITE | Website of replied-to user | "https://example.com" |
| REPLY_AUTHOR_IS_BLUE_VERIFIED | Whether the replied-to user has a blue checkmark | "true" |
| REPLY_AUTHOR_VERIFIED_TYPE | Replied-to user's verification type | "Business" / "Government" |
| REPLY_AUTHOR_AFFILIATE_DESCRIPTION | Replied-to user's affiliate badge description | "BAGS" |
| REPLY_AUTHOR_AFFILIATE_BADGE_URL | Replied-to user's affiliate badge image URL | "https://pbs.twimg.com/..." |
| REPLY_AUTHOR_AFFILIATE_URL | Replied-to user's affiliate link URL | "https://example.com" |
| REPLY_AUTHOR_AFFILIATE_LABEL_TYPE | Replied-to user's affiliate label type | "BusinessLabel" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TWEET",
"SUBTYPE": "NEW_TWEET",
"AUTHOR_ID": "17469289",
"AUTHOR_HANDLE": "nypost",
"AUTHOR_NAME": "New York Post",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/966372680306868224/60wfGe9e_normal.jpg",
"AUTHOR_FOLLOWERS_COUNT": "3736395",
"AUTHOR_BIO": "Breaking news, features and more from the NY Post.",
"AUTHOR_LOCATION": "New York, NY",
"AUTHOR_WEBSITE": "http://www.nypost.com",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_VERIFIED_TYPE": "Business",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/17469289/1444326181",
"AUTHOR_CREATED_AT": "Tue Nov 18 19:46:36 +0000 2008",
"TWEET_ID": "2043394712833241391",
"TWEET_TEXT": "Mamdani's trademark smug videos now undermining agenda: 'Might be a price to pay' https://trib.al/fSiLitC",
"TWEET_LINK": "https://x.com/nypost/status/2043394712833241391",
"IMAGE": "https://pbs.twimg.com/media/HFuYqHWXMAA-4j8.jpg",
"SOURCE_URL": "https://x.com/nypost/status/2043394712833241391",
"LABEL": "good animal news juicers",
"CATEGORY": "NEWS"
},
"_id": "2043394712833241391",
"type": "direct",
"title": "New York Post (@nypost) [good animal news juicers]",
"body": "Mamdani's trademark smug videos now undermining agenda: 'Might be a price to pay' https://trib.al/fSiLitC",
"image": "https://pbs.twimg.com/media/HFuYqHWXMAA-4j8.jpg",
"link": "https://x.com/nypost/status/2043394712833241391",
"icon": "https://pbs.twimg.com/profile_images/966372680306868224/60wfGe9e_normal.jpg",
"requireInteraction": true,
"time": 1776018238634,
"isCustom": true,
"info": {
"twitterId": "17469289",
"isReply": false,
"isSelfReply": false,
"isRetweet": false,
"isQuote": false
},
"suggestions": [],
"urls": []
}Triggered when a tracked tweet's view count crosses a milestone multiplier (2x, 5x, 10x, etc.). Contains the same fields as a regular tweet plus the milestone threshold and current view count.
How to identify: tags.TYPE === "TWEET_VIEWS_MILESTONE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TWEET_VIEWS_MILESTONE" |
| MILESTONE_THRESHOLD | Views multiplier that was crossed | "2" / "5" / "10" |
| VIEW_COUNT | Current view count at time of milestone | "20034" |
| AUTHOR_ID | Twitter user ID | "76766018" |
| AUTHOR_HANDLE | Twitter username | "Dexerto" |
| AUTHOR_NAME | Display name | "Dexerto" |
| AUTHOR_ICON | Profile picture URL | "https://pbs.twimg.com/..." |
| AUTHOR_FOLLOWERS_COUNT | Author's follower count | "1322255" |
| TWEET_ID | Tweet ID | "2041246055941980628" |
| TWEET_TEXT | Tweet content | "A jar of Nutella floating..." |
| TWEET_LINK | URL to tweet | "https://x.com/Dexerto/status/..." |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Attached image URLs | "https://pbs.twimg.com/media/..." |
| VIDEO | Video URL if present | "https://video.twimg.com/..." |
| VIDEO_THUMBNAIL | Video thumbnail | "https://pbs.twimg.com/..." |
| LABEL | Account label if set | "News Outlet" |
| CATEGORY | Account category | "IMPORTANT" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TWEET_VIEWS_MILESTONE",
"AUTHOR_ID": "76766018",
"AUTHOR_HANDLE": "Dexerto",
"AUTHOR_NAME": "Dexerto",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1714301666445402112/5U5myYFv_normal.jpg",
"AUTHOR_FOLLOWERS_COUNT": "1322255",
"AUTHOR_LOCATION": "press[at]dexerto.com",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_VERIFIED_TYPE": "Business",
"AUTHOR_WEBSITE": "https://www.dexerto.com/",
"AUTHOR_BIO": "The leading source for influencer, streamer, gaming, and viral content",
"TWEET_ID": "2041246055941980628",
"TWEET_TEXT": "A jar of Nutella floating inside NASA's Artemis spacecraft is going viral as the perfect accidental ad",
"TWEET_LINK": "https://x.com/Dexerto/status/2041246055941980628",
"VIDEO": "https://video.twimg.com/amplify_video/2041227128142696448/vid/avc1/1920x1036/CCWwMeZr6yX4MeKs.mp4",
"VIEW_COUNT": "20034",
"MILESTONE_THRESHOLD": "2",
"SOURCE_URL": "https://x.com/Dexerto/status/2041246055941980628",
"LABEL": null,
"CATEGORY": "IMPORTANT"
},
"_id": "2041246055941980628",
"type": "direct",
"title": "🎯 Tweet views increased by 2x",
"body": "A jar of Nutella floating inside NASA's Artemis spacecraft is going viral as the perfect accidental ad",
"link": "https://x.com/Dexerto/status/2041246055941980628",
"icon": "https://pbs.twimg.com/profile_images/1714301666445402112/5U5myYFv_normal.jpg",
"requireInteraction": true,
"time": 1775507131438,
"isCustom": true,
"info": {
"twitterId": "76766018",
"isReply": false,
"isSelfReply": false,
"isRetweet": false,
"isQuote": false
},
"suggestions": [],
"urls": []
}Triggered when a tracked account follows another user. Contains info about both the follower and the followed account.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "FOLLOW"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "FOLLOW" |
| AUTHOR_ID | Follower's user ID | "1176026136117166080" |
| AUTHOR_HANDLE | Who followed | "rawsalerts" |
| AUTHOR_NAME | Their display name | "R A W S A L E R T S" |
| AUTHOR_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Author's account creation date | "Mon Sep 23 06:51:06 +0000 2019" |
| AUTHOR_FOLLOWERS_COUNT | Author's follower count | "1691100" |
| AUTHOR_FOLLOWING_COUNT | Author's following count | "42" |
| AUTHOR_BIO | Author's bio | "RawsAlerts is your go-to source for fast, accurate breaking news" |
| AUTHOR_LOCATION | Author's location | "United states" |
| AUTHOR_WEBSITE | Author's website | "https://polymarket.com" |
| AUTHOR_PROFILE_BANNER | Author's banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Author's blue verified status | "true" |
| AUTHOR_VERIFIED_TYPE | Author's verification type | "Business" |
| AUTHOR_AFFILIATE_DESCRIPTION | Author's affiliate org description | "Polymarket" |
| AUTHOR_AFFILIATE_BADGE_URL | Author's affiliate badge image URL | "https://pbs.twimg.com/..." |
| AUTHOR_AFFILIATE_URL | Author's affiliate link URL | "https://twitter.com/Polymarket" |
| AUTHOR_AFFILIATE_LABEL_TYPE | Author's affiliate label type | "BusinessLabel" |
| FOLLOWED_HANDLE | Who was followed | "Real69Minutes" |
| FOLLOWED_NAME | Their display name | "69 Minutes" |
| FOLLOWED_ID | Followed user's ID | "1814788640415096834" |
| FOLLOWED_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| FOLLOWED_BIO | Their bio text | "Welcome to 69 Minutes hosted by Alex Stone!" |
| FOLLOWED_BIO_TRANSLATED | Translated bio if non-English | "... [Translated]" |
| FOLLOWED_BANNER | Their banner image URL | "https://pbs.twimg.com/profile_banners/..." |
| FOLLOWED_FOLLOWERS | Their follower count | "7401" |
| FOLLOWED_FOLLOWING_COUNT | Their following count | "371" |
| FOLLOWED_URL | Their website if set | "http://www.69minutes.media" |
| FOLLOWED_LOCATION | Their location if set | "Only on X" |
| FOLLOWED_CREATED_AT | When followed account was created | "1721514315000" |
| FOLLOWED_IS_BLUE_VERIFIED | Followed user's blue verified status | "true" |
| FOLLOWED_VERIFIED_TYPE | Followed user's verification type | "blue" |
| CONTRACT_ADDRESS | CA detected in bio | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "FOLLOW",
"AUTHOR_ID": "1176026136117166080",
"AUTHOR_HANDLE": "rawsalerts",
"AUTHOR_NAME": "R A W S A L E R T S",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1999972200779005953/JP18SAS8.jpg",
"AUTHOR_CREATED_AT": "Mon Sep 23 06:51:06 +0000 2019",
"AUTHOR_FOLLOWERS_COUNT": "1691100",
"AUTHOR_BIO": "RawsAlerts is your go-to source for fast, accurate breaking news Powered by @Polymarket. More coverage on @RawsGlobal",
"AUTHOR_LOCATION": "United states ",
"AUTHOR_WEBSITE": "https://polymarket.com",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_AFFILIATE_DESCRIPTION": "Polymarket",
"FOLLOWED_HANDLE": "Real69Minutes",
"FOLLOWED_NAME": "69 Minutes",
"FOLLOWED_ID": "1814788640415096834",
"FOLLOWED_ICON": "https://pbs.twimg.com/profile_images/1892720321012101120/L7czvuFv.jpg",
"FOLLOWED_BIO": "Welcome to 69 Minutes hosted by Alex Stone!",
"FOLLOWED_BANNER": "https://pbs.twimg.com/profile_banners/1814788640415096834/1738901036",
"FOLLOWED_FOLLOWERS": "7401",
"FOLLOWED_LOCATION": "Only on X",
"FOLLOWED_URL": "http://www.69minutes.media",
"FOLLOWED_IS_BLUE_VERIFIED": "true",
"SOURCE_URL": "https://x.com/Real69Minutes",
"CATEGORY": "NEWS"
},
"_id": "rawsalerts-TWITTER_FOLLOW-real69minutes",
"source": "Terminal",
"title": "👤 @rawsalerts (R A W S A L E R T S) followed @Real69Minutes (69 Minutes)",
"body": "\n\n📝 Welcome to 69 Minutes hosted by Alex Stone!\n\n👥 7401 followers\n📍 Only on X\n🌐 http://www.69minutes.media",
"icon": "https://pbs.twimg.com/profile_images/1999972200779005953/JP18SAS8.jpg",
"url": "https://x.com/Real69Minutes",
"time": 1775933137114,
"image": "https://pbs.twimg.com/profile_banners/1814788640415096834/1738901036"
}Triggered when a tracked account unfollows another user. Same structure as Follow Event.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "UNFOLLOW"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "UNFOLLOW" |
| AUTHOR_ID | Unfollower's user ID | "44553913" |
| AUTHOR_HANDLE | Who unfollowed | "Nate_Esparza" |
| AUTHOR_NAME | Their display name | "Nate Esparza" |
| AUTHOR_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Author's account creation date | "Thu Jun 04 05:29:03 +0000 2009" |
| AUTHOR_FOLLOWERS_COUNT | Author's follower count | "55911" |
| AUTHOR_BIO | Author's bio | "Ads Product @X" |
| AUTHOR_LOCATION | Author's location | "CU-Boulder" |
| AUTHOR_WEBSITE | Author's website | "https://business.x.com/..." |
| AUTHOR_PROFILE_BANNER | Author's banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Author's blue verified status | "true" |
| AUTHOR_AFFILIATE_DESCRIPTION | Author's affiliate org description | "X" |
| AUTHOR_AFFILIATE_BADGE_URL | Author's affiliate badge image URL | "https://pbs.twimg.com/..." |
| AUTHOR_AFFILIATE_URL | Author's affiliate link URL | "https://twitter.com/X" |
| AUTHOR_AFFILIATE_LABEL_TYPE | Author's affiliate label type | "BusinessLabel" |
| FOLLOWED_ID | Unfollowed user's ID | "3096147528" |
| FOLLOWED_HANDLE | Who was unfollowed | "dom_lucre" |
| FOLLOWED_NAME | Their display name | "Dom Lucre | Breaker of Narratives" |
| FOLLOWED_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| FOLLOWED_BIO | Their bio text | "White House Featured Journalist..." |
| FOLLOWED_BIO_TRANSLATED | Translated bio if non-English | "... [Translated]" |
| FOLLOWED_BANNER | Their banner image URL | "https://pbs.twimg.com/profile_banners/..." |
| FOLLOWED_FOLLOWERS | Their follower count | "1694165" |
| FOLLOWED_FOLLOWING_COUNT | Their following count | "3106" |
| FOLLOWED_LOCATION | Their location if set | "Miami, FL" |
| FOLLOWED_URL | Their website if set | "https://domlucre.org" |
| FOLLOWED_CREATED_AT | When unfollowed account was created | "1426681046000" |
| FOLLOWED_IS_BLUE_VERIFIED | Unfollowed user's blue verified status | "true" |
| FOLLOWED_VERIFIED_TYPE | Unfollowed user's verification type | "blue" |
| CONTRACT_ADDRESS | CA detected in bio | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
| SOURCE_URL | Profile URL | "https://x.com/dom_lucre" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "UNFOLLOW",
"AUTHOR_ID": "44553913",
"AUTHOR_HANDLE": "Nate_Esparza",
"AUTHOR_NAME": "Nate Esparza",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2036562525735755776/39NvLFbs.jpg",
"AUTHOR_CREATED_AT": "Thu Jun 04 05:29:03 +0000 2009",
"AUTHOR_FOLLOWERS_COUNT": "55911",
"AUTHOR_BIO": "Ads Product @X | CU-Boulder Alumni Lead | Tech | Broncos, Avalanche, Nuggets | Opinions are my own",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_AFFILIATE_DESCRIPTION": "X",
"AUTHOR_AFFILIATE_BADGE_URL": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
"AUTHOR_AFFILIATE_URL": "https://twitter.com/X",
"AUTHOR_AFFILIATE_LABEL_TYPE": "BusinessLabel",
"FOLLOWED_ID": "3096147528",
"FOLLOWED_HANDLE": "dom_lucre",
"FOLLOWED_NAME": "Dom Lucre | Breaker of Narratives",
"FOLLOWED_ICON": "https://pbs.twimg.com/profile_images/1997374530206003200/6NCXjZo7.jpg",
"FOLLOWED_BIO": "White House Featured Journalist | The World Stage Is Exposed Here, Let's Break It. Business@domlucre.org",
"FOLLOWED_BANNER": "https://pbs.twimg.com/profile_banners/3096147528/1724367433",
"FOLLOWED_FOLLOWERS": "1694165",
"FOLLOWED_LOCATION": "Miami, FL",
"FOLLOWED_URL": "https://domlucre.org",
"FOLLOWED_IS_BLUE_VERIFIED": "true",
"FOLLOWED_VERIFIED_TYPE": "blue",
"SOURCE_URL": "https://x.com/dom_lucre",
"CATEGORY": "CUSTOM"
},
"_id": "nate_esparza-TWITTER_UNFOLLOW-dom_lucre",
"source": "Terminal",
"title": "👤❌ @Nate_Esparza (Nate Esparza) unfollowed @dom_lucre (Dom Lucre | Breaker of Narratives)",
"body": "\n\n📝 White House Featured Journalist | The World Stage Is Exposed Here, Let's Break It. Business@domlucre.org\n\n👥 1694165 followers\n📍 Miami, FL\n🌐 https://domlucre.org",
"icon": "https://pbs.twimg.com/profile_images/2036562525735755776/39NvLFbs.jpg",
"url": "https://x.com/dom_lucre",
"time": 1775934169108,
"image": "https://pbs.twimg.com/profile_banners/3096147528/1724367433"
}Triggered when a tracked account changes their bio. Includes both old and new bio text.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "BIO_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "BIO_CHANGE" |
| AUTHOR_ID | User ID | "16573941" |
| AUTHOR_HANDLE | Username | "netflix" |
| AUTHOR_NAME | Display name | "Netflix" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1223007377000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "26073545" |
| AUTHOR_LOCATION | Location | "California, USA" |
| AUTHOR_WEBSITE | Website | "https://netflix.com" |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_VERIFIED_TYPE | Verification type | "business" |
| OLD_BIO | Previous bio text | "it's xo kitty week ✨" |
| NEW_BIO | New bio text | "FURY VS MAKHMUDOV" |
| OLD_BIO_TRANSLATED | Old bio translation | "... [Translated]" |
| NEW_BIO_TRANSLATED | New bio translation | "... [Translated]" |
| CONTRACT_ADDRESS | CA detected in new bio | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "BIO_CHANGE",
"AUTHOR_ID": "16573941",
"AUTHOR_HANDLE": "netflix",
"AUTHOR_NAME": "Netflix",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1996301804053868544/Xrwvbe1q.jpg",
"AUTHOR_CREATED_AT": "1223007377000",
"AUTHOR_FOLLOWERS_COUNT": "26073545",
"AUTHOR_LOCATION": "California, USA",
"AUTHOR_WEBSITE": "https://netflix.com",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/16573941/1775920368",
"AUTHOR_VERIFIED_TYPE": "business",
"OLD_BIO": "it's xo kitty week ✨",
"NEW_BIO": "FURY VS MAKHMUDOV",
"SOURCE_URL": "https://x.com/netflix",
"CATEGORY": "COMPANIES"
},
"_id": "netflix-TWITTER_BIO_CHANGE",
"source": "Terminal",
"title": "📝 Netflix (@netflix) updated bio",
"body": "Old: it's xo kitty week ✨\n\nNew: FURY VS MAKHMUDOV",
"icon": "https://pbs.twimg.com/profile_images/1996301804053868544/Xrwvbe1q.jpg",
"url": "https://x.com/netflix",
"time": 1775932752642
}Triggered when a tracked account changes their display name.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "NAME_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "NAME_CHANGE" |
| AUTHOR_ID | User ID | "46302096" |
| AUTHOR_HANDLE | Username | "JoeyMannarino" |
| AUTHOR_NAME | Display name (new name) | "Joey Mannarino" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1244690436000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "672187" |
| AUTHOR_BIO | Bio | "Co-Founder of The Overton Institute..." |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| OLD_NAME | Previous display name | "Joey Mannarino 🇺🇸" |
| NEW_NAME | New display name | "Joey Mannarino" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "NAME_CHANGE",
"AUTHOR_ID": "46302096",
"AUTHOR_HANDLE": "JoeyMannarino",
"AUTHOR_NAME": "Joey Mannarino",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2036192870739144704/1oSuhME__normal.jpg",
"AUTHOR_CREATED_AT": "1244690436000",
"AUTHOR_FOLLOWERS_COUNT": "672187",
"AUTHOR_BIO": "Co-Founder of The Overton Institute. American citizen. Political strategist & commentator working with conservative movements in the US & EU.",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/46302096/1760846788",
"OLD_NAME": "Joey Mannarino 🇺🇸",
"NEW_NAME": "Joey Mannarino",
"SOURCE_URL": "https://x.com/JoeyMannarino",
"CATEGORY": "CUSTOM"
},
"_id": "joeymannarino-TWITTER_NAME_CHANGE",
"source": "Terminal",
"title": "✏️ Joey Mannarino (@JoeyMannarino) updated display name",
"body": "Old: Joey Mannarino 🇺🇸\n\nNew: Joey Mannarino",
"icon": "https://pbs.twimg.com/profile_images/2036192870739144704/1oSuhME__normal.jpg",
"url": "https://x.com/JoeyMannarino",
"time": 1775939310565
}Triggered when a tracked account changes their profile picture.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "PROFILE_PICTURE_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "PROFILE_PICTURE_CHANGE" |
| AUTHOR_ID | User ID | "1565089861245313027" |
| AUTHOR_HANDLE | Username | "iruletheworldmo" |
| AUTHOR_NAME | Display name | "🍓🍓🍓" |
| AUTHOR_ICON | Avatar URL (new avatar) | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1661981517000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "101033" |
| AUTHOR_BIO | Bio | "GPT6 IS ASI" |
| AUTHOR_LOCATION | Location | "sams basement" |
| AUTHOR_WEBSITE | Website | "https://mstrawberryman-ui.github.io/..." |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Blue verified status | "true" |
| AUTHOR_VERIFIED_TYPE | Verification type | "blue" |
| OLD_PROFILE_PICTURE | Previous avatar URL | "https://pbs.twimg.com/..." |
| NEW_PROFILE_PICTURE | New avatar URL | "https://pbs.twimg.com/..." |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "PROFILE_PICTURE_CHANGE",
"AUTHOR_ID": "1565089861245313027",
"AUTHOR_HANDLE": "iruletheworldmo",
"AUTHOR_NAME": "🍓🍓🍓",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"AUTHOR_CREATED_AT": "1661981517000",
"AUTHOR_FOLLOWERS_COUNT": "101033",
"AUTHOR_BIO": "GPT6 IS ASI",
"AUTHOR_LOCATION": "sams basement ",
"AUTHOR_WEBSITE": "https://mstrawberryman-ui.github.io/focus-reader-/",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/1565089861245313027/1764959776",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_VERIFIED_TYPE": "blue",
"OLD_PROFILE_PICTURE": "https://pbs.twimg.com/profile_images/1997010263585783808/DCNgEAb8.jpg",
"NEW_PROFILE_PICTURE": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"SOURCE_URL": "https://x.com/iruletheworldmo",
"CATEGORY": "CUSTOM"
},
"_id": "iruletheworldmo-TWITTER_PROFILE_PICTURE_CHANGE",
"source": "Terminal",
"title": "🖼️ 🍓🍓🍓 (@iruletheworldmo) updated profile picture",
"body": "Profile Image Changed",
"icon": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"image": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"url": "https://x.com/iruletheworldmo",
"time": 1775934829246
}Triggered when a tracked account changes their profile banner.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "BANNER_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "BANNER_CHANGE" |
| AUTHOR_ID | User ID | "1598253668175847425" |
| AUTHOR_HANDLE | Username | "onusoz" |
| AUTHOR_NAME | Display name | "Onur Solmaz" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1669888391000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "4419" |
| AUTHOR_BIO | Bio | "Maintainer @openclaw, Founding Engineer @textcortex..." |
| AUTHOR_WEBSITE | Website | "https://solmaz.io" |
| AUTHOR_PROFILE_BANNER | Banner URL (new banner) | "https://pbs.twimg.com/profile_banners/..." |
| OLD_BANNER | Previous banner URL (empty string if no previous banner) | "" |
| NEW_BANNER | New banner URL | "https://pbs.twimg.com/profile_banners/..." |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "BANNER_CHANGE",
"AUTHOR_ID": "1598253668175847425",
"AUTHOR_HANDLE": "onusoz",
"AUTHOR_NAME": "Onur Solmaz",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1998282426783875072/AD1wK-0c_normal.jpg",
"AUTHOR_CREATED_AT": "1669888391000",
"AUTHOR_FOLLOWERS_COUNT": "4419",
"AUTHOR_BIO": "Maintainer @openclaw, Founding Engineer @textcortex. Trying to define Agentic Engineering",
"AUTHOR_WEBSITE": "https://solmaz.io",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/1598253668175847425/1775932911",
"OLD_BANNER": "",
"NEW_BANNER": "https://pbs.twimg.com/profile_banners/1598253668175847425/1775932911",
"SOURCE_URL": "https://x.com/onusoz",
"CATEGORY": "CUSTOM"
},
"_id": "onusoz-TWITTER_BANNER_CHANGE",
"source": "Terminal",
"title": "🎨 Onur Solmaz (@onusoz) updated banner",
"body": "Profile banner has been changed",
"icon": "https://pbs.twimg.com/profile_images/1998282426783875072/AD1wK-0c_normal.jpg",
"image": "https://pbs.twimg.com/profile_banners/1598253668175847425/1775932911",
"url": "https://x.com/onusoz",
"time": 1775932912287
}Triggered when a tracked account deletes a tweet that was previously captured.
How to identify: tags.TYPE === "TWEET" && tags.SUBTYPE === "DELETED_TWEET"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TWEET" |
| SUBTYPE | Event type | "DELETED_TWEET" |
| AUTHOR_ID | Twitter user ID | "1786465176113561600" |
| AUTHOR_HANDLE | Username | "StrategyMaxi" |
| AUTHOR_NAME | Display name | "100% Strategy" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1714761475000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "10041" |
| AUTHOR_BIO | Bio | "Strategy Maxi - All In $MSTR" |
| AUTHOR_LOCATION | Location | "Strategy" |
| AUTHOR_IS_BLUE_VERIFIED | Blue verified status | "true" |
| AUTHOR_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| TWEET_ID | ID of deleted tweet | "2043389521816097190" |
| DELETED_URL | URL of deleted tweet | "https://x.com/StrategyMaxi/status/..." |
| DELETED_CONTENT | Raw original content (includes RT prefix for retweets) | "I blame on ideological Bitcoiners..." |
| TWEET_TEXT | Tweet content of deleted tweet | "I blame on ideological Bitcoiners..." |
| TWEET_TEXT_TRANSLATED | Translation if non-English | "... [Translated]" |
| SOURCE_URL | URL to the deleted tweet | "https://x.com/StrategyMaxi/status/..." |
| IS_REPLY | Was it a reply | "true" / "false" |
| IS_QUOTE | Was it a quote | "true" / "false" |
| IS_RETWEET | Was it a retweet | "true" / "false" |
| QUOTED_AUTHOR_HANDLE | Username of quoted user | "glove" |
| QUOTED_AUTHOR_NAME | Name of quoted user | "G. Love" |
| QUOTED_AUTHOR_ICON | Avatar of quoted user | "https://pbs.twimg.com/..." |
| QUOTED_TWEET_ID | ID of quoted tweet | "2043047396322451700" |
| QUOTED_TWEET_TEXT | Content of quoted tweet | "I had a really tough day..." |
| QUOTED_TWEET_TEXT_TRANSLATED | Translated quoted tweet | "... [Translated]" |
| QUOTED_TWEET_LINK | URL to quoted tweet | "https://x.com/glove/status/..." |
| QUOTED_AUTHOR_CREATED_AT | Quoted author's account creation date | "Tue Feb 03 19:21:52 +0000 2009" |
| QUOTED_AUTHOR_FOLLOWERS_COUNT | Quoted author's follower count | "65621" |
| QUOTED_AUTHOR_BIO | Quoted author's bio | "My New album..." |
| QUOTED_AUTHOR_LOCATION | Quoted author's location | "Philly, PA!" |
| QUOTED_AUTHOR_PROFILE_BANNER | Quoted author's banner | "https://pbs.twimg.com/profile_banners/..." |
| QUOTED_AUTHOR_WEBSITE | Quoted author's website | "https://ffm.bio/..." |
| REPLY_AUTHOR_HANDLE | Username of replied-to user | "other_user" |
| REPLY_AUTHOR_NAME | Name of replied-to user | "Other User" |
| REPLY_TWEET_TEXT | Content of replied-to tweet | "Original reply text..." |
| REPLY_TWEET_TEXT_TRANSLATED | Translated reply tweet | "... [Translated]" |
| RETWEET_AUTHOR_HANDLE | Username of retweeted user | "magills_" |
| RETWEET_AUTHOR_NAME | Name of retweeted user | "Magills" |
| RETWEET_AUTHOR_ICON | Avatar of retweeted user | "https://pbs.twimg.com/..." |
| RETWEET_TWEET_ID | ID of retweeted tweet | "2043346264822010275" |
| RETWEET_TWEET_TEXT | Content of retweeted tweet | "Retweeted content..." |
| RETWEET_TWEET_TEXT_TRANSLATED | Translated retweet | "... [Translated]" |
| RETWEET_TWEET_LINK | URL to retweeted tweet | "https://x.com/magills_/status/..." |
| RETWEET_AUTHOR_CREATED_AT | Retweeted author's account creation date | "Mon Jan 02 02:26:35 +0000 2017" |
| RETWEET_AUTHOR_FOLLOWERS_COUNT | Retweeted author's follower count | "38064" |
| RETWEET_AUTHOR_BIO | Retweeted author's bio | "I fix broken buildings..." |
| RETWEET_AUTHOR_LOCATION | Retweeted author's location | "The Midwest" |
| RETWEET_AUTHOR_PROFILE_BANNER | Retweeted author's banner | "https://pbs.twimg.com/profile_banners/..." |
| RETWEET_AUTHOR_IS_BLUE_VERIFIED | Retweeted author's blue verified status | "true" |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Images from deleted tweet | "https://pbs.twimg.com/media/..." |
| VIDEO | Video from deleted tweet | "https://video.twimg.com/..." |
| VIDEO_THUMBNAIL | Video thumbnail | "https://pbs.twimg.com/..." |
| CONTRACT_ADDRESS | CA if detected in tweet | "Dde2MApjiq...pump" |
| CHAIN | Blockchain if CA detected | "SOL" |
| LABEL | Account label (user-defined) | "Alpha Trader" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TWEET",
"SUBTYPE": "DELETED_TWEET",
"AUTHOR_ID": "1786465176113561600",
"AUTHOR_HANDLE": "StrategyMaxi",
"AUTHOR_NAME": "100% Strategy",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2042056285622038532/bc6m9iR6_normal.jpg",
"AUTHOR_CREATED_AT": "1714761475000",
"AUTHOR_FOLLOWERS_COUNT": "10041",
"AUTHOR_BIO": "Strategy Maxi - All In $MSTR",
"AUTHOR_LOCATION": "Strategy",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_BANNER": "https://pbs.twimg.com/profile_banners/1786465176113561600/1774364739",
"TWEET_ID": "2043389521816097190",
"DELETED_URL": "https://x.com/StrategyMaxi/status/2043389521816097190",
"DELETED_CONTENT": "I blame on ideological Bitcoiners preaching self custody.\n\nTime to normalize the trust in custodians.\n\nWe have rise of AI being efficient in hacking and etc.\n\nCustodians will outperform self custody wallets in cybersecurity as custodians will have access to cutting edge AI. https://t.co/Qh5rpWWpl0",
"TWEET_TEXT": "I blame on ideological Bitcoiners preaching self custody.\n\nTime to normalize the trust in custodians.\n\nWe have rise of AI being efficient in hacking and etc.\n\nCustodians will outperform self custody wallets in cybersecurity as custodians will have access to cutting edge AI. https://t.co/Qh5rpWWpl0",
"IS_REPLY": "false",
"IS_QUOTE": "true",
"IS_RETWEET": "false",
"QUOTED_AUTHOR_HANDLE": "glove",
"QUOTED_AUTHOR_NAME": "G. Love",
"QUOTED_AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1873855589291266049/hYka0NCi_normal.jpg",
"QUOTED_TWEET_ID": "2043047396322451700",
"QUOTED_TWEET_LINK": "https://x.com/glove/status/2043047396322451700",
"QUOTED_TWEET_TEXT": "I had a really tough day today I lost my retirement fund in a hack/Scam when I switched my @Ledger over to my new computer and by accident downloaded a malicious ledger app from the @Apple store. All my BTC gone in an instant.",
"QUOTED_AUTHOR_CREATED_AT": "Tue Feb 03 19:21:52 +0000 2009",
"QUOTED_AUTHOR_FOLLOWERS_COUNT": "65621",
"QUOTED_AUTHOR_BIO": "My New album Ode To R.L. OUT NOW!!",
"QUOTED_AUTHOR_LOCATION": "Philly, PA!",
"SOURCE_URL": "https://x.com/StrategyMaxi/status/2043389521816097190",
"CATEGORY": "CUSTOM"
},
"_id": "strategymaxi-TWITTER_DELETED-2043389521816097190",
"source": "Terminal",
"title": "🗑️ @StrategyMaxi deleted quote (posted 23m ago)",
"body": "I blame on ideological Bitcoiners preaching self custody.\n\nTime to normalize the trust in custodians...",
"icon": "https://pbs.twimg.com/profile_images/2042056285622038532/bc6m9iR6_normal.jpg",
"url": "https://x.com/StrategyMaxi/status/2043389521816097190",
"time": 1776018387143
}Messages from tracked Telegram channels. Includes channel info, message content, and detected contract addresses.
How to identify: tags.TYPE === "NEW_TELEGRAM_MESSAGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain if CA detected | "ETHEREUM" |
| CONTRACT_ADDRESS | Detected token CA | "0x548fefd928..." |
| CHANNEL_ID | Telegram channel ID | "basepairs" |
| CHANNEL_NAME | Channel display name | "Base new Pairs / Contracts" |
| CHANNEL_ICON | Channel avatar URL | "https://cdn4.telesco.pe/..." |
| MESSAGE_ID | Message ID | "696e8a6f22a5d24755424516" |
| MESSAGE_TEXT | Message content | "📜 New contract deployed!..." |
| MESSAGE_TEXT_TRANSLATED | Translation if non-English | "... [Translated]" |
| MESSAGE_IMAGE | Attached image URL | "https://..." |
| MESSAGE_LINK | Link to message | "https://t.me/BasePairs/2957755" |
| IS_FORWARD | Whether message is forwarded | "true" |
| FORWARDED_CHANNEL_ID | Original channel handle | "monitoringsituation" |
| FORWARDED_CHANNEL_NAME | Original channel name | "Monitoring The Situation" |
| FORWARDED_MESSAGE_ID | Original message ID | "4304" |
| FORWARDED_MESSAGE_LINK | Link to original message | "https://t.me/MonitoringSituation/4304" |
Example
{
"tags": {
"CHAIN": "ETHEREUM",
"CONTRACT_ADDRESS": "0x548fefd9284367c183d4a0aB2aD7e87429Ee8489",
"CHANNEL_ID": "basepairs",
"CHANNEL_NAME": "Base new Pairs / Contracts | Prodigy Bots",
"CHANNEL_ICON": "https://cdn4.telesco.pe/file/QwOXy7HXzP6DlOPbCSBd1CGxRIKcnrIOGUcr...",
"MESSAGE_ID": "696e8a6f22a5d24755424516",
"MESSAGE_TEXT": "base | 📜 New contract deployed! 📜\n🔗 Token: Shiba Spark ($SHIBASK)\n0x548fefd9284367c183d4a0aB2aD7e87429Ee8489\n🏦 Supply: 1000000 | 18 decimals",
"MESSAGE_IMAGE": null,
"MESSAGE_LINK": "https://t.me/BasePairs/2957755",
"IS_FORWARD": "false"
},
"_id": "696e8a6f22a5d24755424516",
"title": "📱 Base new Pairs / Contracts | Prodigy Bots",
"body": "base | 📜 New contract deployed!..."
}Posts from tracked Truth Social accounts (e.g., Trump). Includes author info, post content, and media.
How to identify: tags.TYPE === "TRUTH_SOCIAL" && tags.SUBTYPE === "POST"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TRUTH_SOCIAL" |
| SUBTYPE | Event type | "POST" |
| AUTHOR_ID | Truth Social user ID | "107780257626128497" |
| AUTHOR_TWITTER_ID | Linked Twitter ID | "107780257626128497" |
| AUTHOR_USERNAME | Username | "realDonaldTrump" |
| AUTHOR_DISPLAY_NAME | Display name | "Donald J. Trump" |
| AUTHOR_ICON | Profile picture URL | "https://..." |
| POST_ID | Post ID | "115923723486523883" |
| POST_TEXT | Post content | "..." |
| POST_URL | URL to post | "https://truthsocial.com/@realDonaldTrump/..." |
| IMAGE | Attached image URL | "https://..." |
| VIDEO | Attached video URL | "https://..." |
| SOURCE_URL | URL to the post | "https://truthsocial.com/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TRUTH_SOCIAL",
"SUBTYPE": "POST",
"AUTHOR_ID": "107780257626128497",
"AUTHOR_TWITTER_ID": "107780257626128497",
"AUTHOR_USERNAME": "realDonaldTrump",
"AUTHOR_DISPLAY_NAME": "Donald J. Trump",
"AUTHOR_ICON": "https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fstatic-assets-1.truthsocial.com%2Ftmtg%3Aprime-ts-assets%2Faccounts%2Favatars%2F107%2F780%2F257%2F626%2F128%2F497%2Foriginal%2F454286ac07a6f6e6.jpeg&f=1",
"POST_ID": "115923723486523883",
"POST_TEXT": "",
"POST_URL": "https://truthsocial.com/@realDonaldTrump/115923723486523883",
"IMAGE": "https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fstatic-assets-1.truthsocial.com%2Ftmtg%3Aprime-ts-assets%2Fmedia_attachments%2Ffiles%2F115%2F923%2F722%2F130%2F275%2F809%2Foriginal%2F1700034b49a05d98.jpg&f=1",
"SOURCE_URL": "https://truthsocial.com/@realDonaldTrump/115923723486523883"
},
"_id": "115923723486523883",
"type": "direct",
"title": "Donald J. Trump (@realDonaldTrump)",
"body": "",
"link": "https://truthsocial.com/@realDonaldTrump/115923723486523883",
"time": 1768855644024
}Posts from tracked Warpcast/Farcaster accounts. Similar structure to other social media posts.
How to identify: tags.TYPE === "WARPCAST" && tags.SUBTYPE === "POST"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "WARPCAST" |
| SUBTYPE | Event type | "POST" |
| AUTHOR_ID | Farcaster user ID | "12345" |
| AUTHOR_USERNAME | Username (lowercase) | "vitalik.eth" |
| AUTHOR_DISPLAY_NAME | Display name | "Vitalik Buterin" |
| AUTHOR_ICON | Profile picture URL | "https://..." |
| CAST_ID | Cast hash ID | "0x..." |
| CAST_TEXT | Cast content | "..." |
| POST_URL | URL to post | "https://warpcast.com/..." |
| IS_REPLY | Is this a reply to another cast | "true" / "false" |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Attached image URLs | "https://..." |
| VIDEO / VIDEO2 / VIDEO3 / VIDEO4 | Attached video URLs | "https://..." |
| CONTRACT_ADDRESS | CA if detected | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
Example
{
"tags": {
"TYPE": "WARPCAST",
"SUBTYPE": "POST",
"AUTHOR_USERNAME": "vitalik.eth",
"AUTHOR_DISPLAY_NAME": "Vitalik Buterin",
"POST_ID": "0xabc123",
"POST_TEXT": "Interesting thoughts on...",
"POST_URL": "https://warpcast.com/vitalik.eth/0xabc123"
},
"_id": "warpcast-0xabc123",
"title": "Vitalik Buterin (@vitalik.eth)",
"body": "Interesting thoughts on..."
}Token swap transactions from tracked wallets. Includes trade direction, amounts, token info, and market data.
How to identify: tags.TYPE === "WALLET_SWAP"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "BASE" / "SOL" |
| CONTRACT_ADDRESS | Swapped token address | "0x7df3fd4e53..." |
| WALLET_ADDRESS | Wallet address | "0x5b0051e4ea..." |
| WALLET_LABEL | Wallet label if set | "b2" |
| WALLET_URL | Block explorer URL | "https://basescan.org/address/..." |
| TRANSACTION_ACTION | BUY or SELL | "BUY" |
| TRANSACTION_TYPE | Transaction type | "SWAP" |
| TRANSACTION_PLATFORM | DEX/platform used | "RAYDIUM" / "PUMP_FUN" |
| TRANSACTION_ID | Transaction hash | "0x83196361e82b..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768852449" |
| FROM_TOKEN_TICKER | Token sold symbol | "WETH" |
| FROM_TOKEN_AMOUNT | Amount sold | "0.25" |
| TO_TOKEN_TICKER | Token bought symbol | "SMILE" |
| TO_TOKEN_AMOUNT | Amount bought | "7497.501388487983" |
| BASE_TOKEN_TICKER | Base currency | "WETH" |
| BASE_TOKEN_AMOUNT_USD | USD value of trade | "820.315" |
| SWAPPED_TOKEN_ADDRESS | Token contract address | "0x7df3fd4e53..." |
| SWAPPED_TOKEN_TICKER | Token symbol | "SMILE" |
| SWAPPED_TOKEN_NAME | Token name | "SMILE" |
| SWAPPED_TOKEN_AMOUNT | Amount swapped | "7497.501388487983" |
| SWAPPED_TOKEN_IMAGE_URL | Token image | "https://logos.uniwhales.io/..." |
| SWAPPED_TOKEN_MARKET_CAP_USD | Market cap | "5000000" |
| SWAPPED_TOKEN_SUPPLY_PERCENTAGE | % of supply traded | "0.5" |
| SWAPPED_TOKEN_BALANCE | Post-trade balance | "1000000" |
| SWAPPED_TOKEN_BALANCE_USD | Balance in USD | "150.00" |
| SWAPPED_TOKEN_BALANCE_SUPPLY_PERCENTAGE | Balance % of supply | "0.1" |
| FIRST_INTERACTION | First time wallet interacted with token | "true" / "false" |
| TRANSACTION_URL | Block explorer URL for transaction | "https://solscan.io/tx/..." |
| PREFERRED_TRADING_URL | Best trading URL | "https://gmgn.ai/..." |
| PHOTON_URL | Photon trading URL | "https://photon-base.tinyastro.io/..." |
| FOMO_URL | FOMO trading URL | "https://fomo.family/tokens/base/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"CHAIN": "BASE",
"CONTRACT_ADDRESS": "0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"WALLET_ADDRESS": "0x5b0051e4ea8eaf6ec523ab2aa76fe0149e68b040",
"WALLET_LABEL": "b2",
"WALLET_URL": "https://basescan.org/address/0x5b0051e4ea8eaf6ec523ab2aa76fe0149e68b040",
"TRANSACTION_ACTION": "BUY",
"TRANSACTION_TYPE": "SWAP",
"TRANSACTION_PLATFORM": "SIGMAWIN",
"TRANSACTION_ID": "0x83196361e82b0658da088dd240d9a6e54e1816d556a922f3baa1cf8544cf28df",
"TRANSACTION_TIMESTAMP": "1768852449",
"FROM_TOKEN_TICKER": "WETH",
"FROM_TOKEN_AMOUNT": "0.25",
"TO_TOKEN_TICKER": "SMILE",
"TO_TOKEN_AMOUNT": "7497.501388487983",
"BASE_TOKEN_TICKER": "WETH",
"BASE_TOKEN_AMOUNT_USD": "820.315",
"SWAPPED_TOKEN_ADDRESS": "0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"SWAPPED_TOKEN_TICKER": "SMILE",
"SWAPPED_TOKEN_NAME": "SMILE",
"SWAPPED_TOKEN_AMOUNT": "7497.501388487983",
"SWAPPED_TOKEN_IMAGE_URL": "https://logos.uniwhales.io/base/0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a.jpg",
"PREFERRED_TRADING_URL": "https://gmgn.ai/base/token/bark_0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"PHOTON_URL": "https://photon-base.tinyastro.io/en/r/@risitas/0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a"
},
"_id": "0x831-WALLET_SWAP",
"source": "Terminal",
"title": "🟢[b2] swapped 0.25 WETH to 7498 SMILE",
"body": "\n📈 TRADE: https://gmgn.ai/base/token/bark_0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"url": "https://gmgn.ai/base/token/bark_0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"time": 1768852450751
}Token transfer received by a tracked wallet. Includes sender/receiver info and token details.
How to identify: tags.TYPE === "TOKEN_RECEIVED"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| CONTRACT_ADDRESS | Token address | "8vzmc7He4DDxzU..." |
| WALLET_ADDRESS | Receiver wallet | "42cfcPtPRHN6YQ..." |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| TRANSACTION_TYPE | Transaction type | "TOKEN_RECEIVED" |
| TRANSACTION_ID | Transaction hash | "2JmVD2GGr9Mzkd..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| TOKEN_ADDRESS | Token contract | "8vzmc7He4DDxzU..." |
| TOKEN_TICKER | Token symbol | "SPS" |
| TOKEN_NAME | Token name | "Solid Poops Season" |
| TOKEN_IMAGE_URL | Token image | "https://ipfs.io/ipfs/..." |
| TOKEN_AMOUNT | Amount transferred | "1.0E7" |
| TOKEN_AMOUNT_USD | USD value | "0.0" |
| TOKEN_BALANCE | Balance after | "1.0E7" |
| TOKEN_BALANCE_USD | Balance USD value | "0.0" |
| TOKEN_PRICE_USD | Token price | "0.0" |
| TOKEN_SUPPLY | Total supply | "1.0E9" |
| TOKEN_SUPPLY_PERCENTAGE | % of supply transferred | "1.0" |
| TOKEN_BALANCE_SUPPLY_PERCENTAGE | Balance % of supply | "1.0" |
| TOKEN_MARKET_CAP_USD | Market cap | "0.0" |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| SENDER_ADDRESS | Sender wallet | "H5jbQTiL2FVxPi..." |
| SENDER_LABEL | Label for sender wallet if set | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "1.0881978609146E7" |
| RECEIVER_ADDRESS | Receiver wallet | "42cfcPtPRHN6YQ..." |
| RECEIVER_LABEL | Receiver label if set | "BonkFun Dev" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "1.0E7" |
| COUNTERPARTY_ADDRESS | Other party address | "H5jbQTiL2FVxPi..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| PREFERRED_TRADING_URL | Best trading URL | "https://trade.padre.gg/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"CHAIN": "SOL",
"CONTRACT_ADDRESS": "8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk",
"WALLET_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"WALLET_URL": "https://solscan.io/address/42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"TRANSACTION_TYPE": "TOKEN_RECEIVED",
"TRANSACTION_ID": "2JmVD2GGr9Mzkd9yoANKpChCnCZe7bKTBHFA2xuLjjizBY3FHugaAw16Tt2DTY7R1zvxz4HvcVpSckCwnG9otMKE",
"TRANSACTION_TIMESTAMP": "1768856761",
"TOKEN_ADDRESS": "8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk",
"TOKEN_TICKER": "SPS",
"TOKEN_NAME": "Solid Poops Season",
"TOKEN_IMAGE_URL": "https://ipfs.io/ipfs/bafybeihfq5qiqxql2mrj4b2ikulos5cza52di3gbgqloidshvt53shzibe",
"TOKEN_AMOUNT": "1.0E7",
"TOKEN_BALANCE": "1.0E7",
"SENDER_ADDRESS": "H5jbQTiL2FVxPihbsds3H5FBDCdm84sXP5on6p5VWNvU",
"RECEIVER_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"RECEIVER_LABEL": "BonkFun Dev",
"COUNTERPARTY_ADDRESS": "H5jbQTiL2FVxPihbsds3H5FBDCdm84sXP5on6p5VWNvU",
"PREFERRED_TRADING_URL": "https://trade.padre.gg/trade/solana/8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk?rk=bark",
"SOURCE_URL": "https://solscan.io/tx/2JmVD2GGr9Mzkd9yoANKpChCnCZe7bKTBHFA2xuLjjizBY3FHugaAw16Tt2DTY7R1zvxz4HvcVpSckCwnG9otMKE"
},
"_id": "2JmVD-TOKEN_RECEIVED",
"type": "TOKEN_RECEIVED",
"source": "Terminal",
"title": "📥 [BonkFun Dev] received 10000000 SPS from [H5jbQT...5VWNvU]",
"body": "8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk\n----------\n📈 TRADE: https://trade.padre.gg/trade/solana/8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk?rk=bark",
"url": "https://solscan.io/address/42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"time": 1768856761456
}Token transfer sent from a tracked wallet. Same structure as Token Received.
How to identify: tags.TYPE === "TOKEN_SENT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| CONTRACT_ADDRESS | Token address | "8vzmc7He4DDxzU..." |
| WALLET_ADDRESS | Sender wallet | "42cfcPtPRHN6YQ..." |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| TRANSACTION_TYPE | Transaction type | "TOKEN_SENT" |
| TRANSACTION_ID | Transaction hash | "2JmVD2GGr9Mzkd..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| TOKEN_ADDRESS | Token contract | "8vzmc7He4DDxzU..." |
| TOKEN_TICKER | Token symbol | "SPS" |
| TOKEN_NAME | Token name | "Solid Poops Season" |
| TOKEN_IMAGE_URL | Token image | "https://ipfs.io/ipfs/..." |
| TOKEN_AMOUNT | Amount transferred | "1.0E7" |
| TOKEN_AMOUNT_USD | USD value | "0.0" |
| TOKEN_PRICE_USD | Token price | "0.0" |
| TOKEN_BALANCE | Balance after | "1.0E7" |
| TOKEN_BALANCE_USD | Balance USD value | "0.0" |
| TOKEN_SUPPLY | Total supply | "1.0E9" |
| TOKEN_SUPPLY_PERCENTAGE | % of supply transferred | "1.0" |
| TOKEN_BALANCE_SUPPLY_PERCENTAGE | Balance % of supply | "1.0" |
| TOKEN_MARKET_CAP_USD | Market cap | "0.0" |
| SENDER_ADDRESS | Sender wallet | "42cfcPtPRHN6YQ..." |
| SENDER_LABEL | Label for sender wallet if set | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "0" |
| SENDER_BALANCE_AFTER_USD | Sender balance USD | "0.0" |
| SENDER_BALANCE_SUPPLY_PERCENTAGE | Sender balance % of supply | "0.0" |
| RECEIVER_ADDRESS | Receiver wallet | "H5jbQTiL2FVxPi..." |
| RECEIVER_LABEL | Receiver label if set | "BonkFun Dev" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "1.0E7" |
| RECEIVER_BALANCE_AFTER_USD | Receiver balance USD | "0.0" |
| RECEIVER_BALANCE_SUPPLY_PERCENTAGE | Receiver balance % of supply | "1.0" |
| COUNTERPARTY_ADDRESS | Other party address | "H5jbQTiL2FVxPi..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| PREFERRED_TRADING_URL | Best trading URL | "https://trade.padre.gg/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"tags": {
"CHAIN": "SOL",
"TRANSACTION_TYPE": "TOKEN_SENT",
"TOKEN_TICKER": "PEPE",
"TOKEN_AMOUNT": "1000000",
"SENDER_ADDRESS": "your_wallet_address",
"RECEIVER_ADDRESS": "recipient_wallet_address"
},
"_id": "abc123-TOKEN_SENT",
"title": "📤 [Your Wallet] sent 1000000 PEPE to [Recipient]"
}Native SOL transfer received by a tracked wallet. Simpler structure than token transfers.
How to identify: tags.TYPE === "SOL_RECEIVED"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Always SOL | "SOL" |
| TRANSACTION_TYPE | Transaction type | "SOL_RECEIVED" |
| TRANSACTION_ID | Transaction hash | "abc..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| WALLET_ADDRESS | Receiver wallet | "abc..." |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| SOL_AMOUNT | Amount in SOL | "1.5" |
| WALLET_BALANCE_AFTER | Balance after transfer | "10.5" |
| SENDER_ADDRESS | Sender wallet | "xyz..." |
| SENDER_LABEL | Label for sender wallet | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "10.5" |
| RECEIVER_ADDRESS | Receiver wallet | "abc..." |
| RECEIVER_LABEL | Label for receiver wallet | "CEX Deposit" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "5.0" |
| COUNTERPARTY_ADDRESS | Other party address | "xyz..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"tags": {
"CHAIN": "SOL",
"TRANSACTION_TYPE": "SOL_RECEIVED",
"WALLET_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"SOL_AMOUNT": "1.5",
"SENDER_ADDRESS": "H5jbQTiL2FVxPihbsds3H5FBDCdm84sXP5on6p5VWNvU",
"RECEIVER_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"TRANSACTION_ID": "abc123..."
},
"_id": "abc123-SOL_RECEIVED",
"title": "📥 Received 1.5 SOL"
}Native SOL transfer sent from a tracked wallet. Same structure as SOL Received.
How to identify: tags.TYPE === "SOL_SENT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Always SOL | "SOL" |
| TRANSACTION_TYPE | Transaction type | "SOL_SENT" |
| TRANSACTION_ID | Transaction hash | "abc..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| WALLET_ADDRESS | Sender wallet | "abc..." |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| SOL_AMOUNT | Amount in SOL | "1.5" |
| WALLET_BALANCE_AFTER | Balance after transfer | "10.5" |
| SENDER_ADDRESS | Sender wallet | "abc..." |
| SENDER_LABEL | Label for sender wallet | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "10.5" |
| RECEIVER_ADDRESS | Receiver wallet | "xyz..." |
| RECEIVER_LABEL | Label for receiver wallet | "CEX Deposit" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "5.0" |
| COUNTERPARTY_ADDRESS | Other party address | "xyz..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"tags": {
"CHAIN": "SOL",
"TRANSACTION_TYPE": "SOL_SENT",
"SOL_AMOUNT": "1.5"
},
"_id": "abc123-SOL_SENT",
"title": "📤 Sent 1.5 SOL"
}Perpetual futures position changes from tracked wallets. Includes position type (LONG/SHORT), action (OPEN/CLOSE/ADD/REDUCE), and size info.
How to identify: tags.TYPE === "PERP_POSITION"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain/platform | "HYPERLIQUID" |
| WALLET_ADDRESS | Trader wallet | "0x8f8b4759dc93..." |
| WALLET_LABEL | Wallet label if set | "Mister Todd" |
| TRANSACTION_ACTION | BUY or SELL | "BUY" |
| TRANSACTION_PLATFORM | Exchange platform | "HYPERLIQUID" |
| TRANSACTION_ID | Transaction hash | "0x5903d6548ff2..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768852121" |
| TOKEN_TICKER | Asset being traded | "SOL" |
| TOKEN_AMOUNT | Position size change | "15.030000000000001" |
| TOKEN_AMOUNT_USD | USD value of change | "2020.6332000000002" |
| AVERAGE_PRICE | Entry/exit price | "134.44" |
| POSITION_ACTION | OPEN/CLOSE/ADD/REDUCE | "OPEN" |
| POSITION_TYPE | LONG or SHORT | "LONG" |
| POSITION_CHANGE_PERCENT | % change in position | "Infinity" (new position) |
| OLD_POSITION_SIZE | Size before | "0.0" |
| OLD_POSITION_SIZE_USD | USD value before | "0.0" |
| NEW_POSITION_SIZE | Size after | "15.030000000000001" |
| NEW_POSITION_SIZE_USD | USD value after | "2020.6332000000002" |
| IS_LIQUIDATION | Was position liquidated | "true" / "false" |
Example
{
"tags": {
"CHAIN": "HYPERLIQUID",
"WALLET_ADDRESS": "0x8f8b4759dc93ca55bd6997df719f20f581f10f5c",
"WALLET_LABEL": "Mister Todd",
"TRANSACTION_ACTION": "BUY",
"TRANSACTION_PLATFORM": "HYPERLIQUID",
"TRANSACTION_ID": "0x5903d6548ff29b33d43e7a4050d0483b968aa953c910996889540d45b5984c57aggr",
"TRANSACTION_TIMESTAMP": "1768852121",
"TOKEN_TICKER": "SOL",
"TOKEN_AMOUNT": "15.030000000000001",
"TOKEN_AMOUNT_USD": "2020.6332000000002",
"AVERAGE_PRICE": "134.44",
"POSITION_ACTION": "OPEN",
"POSITION_TYPE": "LONG",
"POSITION_CHANGE_PERCENT": "Infinity",
"OLD_POSITION_SIZE": "0.0",
"OLD_POSITION_SIZE_USD": "0.0",
"NEW_POSITION_SIZE": "15.030000000000001",
"NEW_POSITION_SIZE_USD": "2020.6332000000002",
"IS_LIQUIDATION": "false"
},
"_id": "0x5903-PERP_POSITION",
"title": "📈 [Mister Todd] OPENED LONG 15.03 SOL @ $134.44",
"body": "Position size: $2,020.63"
}Triggered when multiple tracked wallets buy the same token within a short time window. Useful for detecting coordinated buys or trending tokens.
How to identify: tags.TYPE === "AGGREGATED_BUY"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| CONTRACT_ADDRESS | Token address | "Trove4jcQhE1dZ..." |
| WALLET_COUNT | Number of wallets that bought | "10" |
| THRESHOLD | Minimum wallet threshold | "10" |
| MINUTES | Time window in minutes | "2" |
| TOTAL_BUY_AMOUNT_USD | Total USD value bought | "38323.34473281339" |
| TOKEN_TICKER | Token symbol | "TROVE" |
| TOKEN_NAME | Token name | "TROVE" |
| TOKEN_MARKET_CAP_USD | Current market cap | "8876599.037534805" |
| TOKEN_IMAGE_URL | Token image URL | "https://gateway.irys.xyz/..." |
| TOKEN_TWITTER | Token's Twitter handle | "@newtoken" |
| TOKEN_TELEGRAM | Token's Telegram link | "https://t.me/newtoken" |
| TOKEN_WEBSITE | Token's website URL | "https://newtoken.xyz" |
| BULLX_URL | BullX trading URL | "https://bullx.io/terminal?..." |
| AXIOM_URL | Axiom trading URL | "https://axiom.trade/t/..." |
| PHOTON_URL | Photon trading URL | "https://photon-sol.tinyastro.io/..." |
| FOMO_URL | FOMO trading URL | "https://fomo.family/tokens/solana/..." |
| SOURCE_URL | Token explorer URL | "https://solscan.io/token/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"CHAIN": "SOL",
"CONTRACT_ADDRESS": "Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ",
"WALLET_COUNT": "10",
"THRESHOLD": "10",
"MINUTES": "2",
"TOTAL_BUY_AMOUNT_USD": "38323.34473281339",
"TOKEN_TICKER": "TROVE",
"TOKEN_NAME": "TROVE",
"TOKEN_MARKET_CAP_USD": "8876599.037534805",
"TOKEN_IMAGE_URL": "https://gateway.irys.xyz/3Yh5ZMsyKx5FDCw1crJfFdnrwKBEU2MTZ3fMFem44Awt",
"BULLX_URL": "https://bullx.io/terminal?chainId=1399811149&address=Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ&r=ZCMO2CXX4JA",
"AXIOM_URL": "https://axiom.trade/t/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ/@risi?chain=sol",
"PHOTON_URL": "https://photon-sol.tinyastro.io/en/r/@risitas/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ",
"SOURCE_URL": "https://solscan.io/token/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ"
},
"_id": "9c8d0-AGGREGATED_BUY",
"source": "Terminal",
"title": "🟢 10 wallets bought $38k of TROVE in the last 2 minutes. Current market cap: $8.9M",
"body": "Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ\n----------",
"url": "https://solscan.io/token/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ",
"time": 1768853008938
}AI-filtered news articles from tracked sources. Includes keyword matching and AI-generated summaries.
How to identify: tags.TYPE === "NEWS_ARTICLE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEWS_ARTICLE" |
| MATCHED_KEYWORD | Keyword that triggered match | "bitcoin" |
| SUMMARY | AI-generated summary | "Bitcoin reaches new ATH..." |
| NAMES | Comma-separated names extracted | "Bitcoin, BTC" |
Example
{
"tags": {
"TYPE": "NEWS_ARTICLE",
"MATCHED_KEYWORD": "bitcoin etf",
"SUMMARY": "SEC approves first spot Bitcoin ETF, marking a historic moment for cryptocurrency adoption.",
"NAMES": "Bitcoin, SEC, BlackRock"
},
"_id": "news-article-123456",
"source": "Terminal",
"title": "SEC Approves Spot Bitcoin ETF",
"body": "In a landmark decision, the Securities and Exchange Commission...",
"url": "https://example.com/news/bitcoin-etf",
"time": 1768853008938
}Posts from tracked Binance Square users. Includes author info and post content.
How to identify: tags.TYPE === "BINANCE_SQUARE_POST"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "BINANCE_SQUARE_POST" |
| ARTICLE_ID | Post identifier | "123456789" |
| USERNAME | Poster username | "cz_binance" |
| DISPLAY_NAME | Display name | "CZ" |
| TITLE | Post title (optional) | "Market Update" |
| CONTENT | Post content | "The market is looking strong..." |
| IMAGE_URL | Cover image URL (optional) | "https://..." |
| AVATAR | Poster avatar URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "BINANCE_SQUARE_POST",
"ARTICLE_ID": "123456789012345678",
"USERNAME": "cz_binance",
"DISPLAY_NAME": "CZ",
"TITLE": "Market Thoughts",
"CONTENT": "Here's my take on the current market conditions...",
"IMAGE_URL": "https://public.bnbstatic.com/image/...",
"AVATAR": "https://public.bnbstatic.com/avatar/..."
},
"_id": "binance-square-123456789",
"source": "Terminal",
"title": "CZ (@cz_binance) - Market Thoughts",
"body": "Here's my take on the current market conditions...",
"time": 1768853008938
}New token listings on Binance Alpha. Includes token info and market data.
How to identify: tags.TYPE === "BINANCE_ALPHA_LISTING"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "BINANCE_ALPHA_LISTING" |
| CONTRACT_ADDRESS | Token contract address | "0x..." |
| CHAIN | Blockchain | "BASE" / "SOL" / "BNB" |
| NAME | Token name | "Pepe Token" |
| SYMBOL | Token symbol | "PEPE" |
| MARKET_CAP_USD | Market cap in USD | "5000000" |
| ICON | Token icon URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "BINANCE_ALPHA_LISTING",
"CONTRACT_ADDRESS": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"CHAIN": "ETHEREUM",
"NAME": "Pepe",
"SYMBOL": "PEPE",
"MARKET_CAP_USD": "5000000000",
"ICON": "https://assets.coingecko.com/coins/images/29850/large/pepe.png"
},
"_id": "binance-alpha-pepe",
"source": "Terminal",
"title": "New Binance Alpha Listing: PEPE",
"body": "Pepe ($PEPE) has been listed on Binance Alpha",
"time": 1768853008938
}New token listings on Moonshot platform.
How to identify: tags.TYPE === "MOONSHOT_LISTING"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "MOONSHOT_LISTING" |
| TOKEN_TICKER | Token symbol | "MOON" |
| CONTRACT_ADDRESS | Token contract address | "abc123..." |
| TOKEN_NAME | Token name | "Moonshot Token" |
| CHAIN | Blockchain | "SOL" / "ETH" |
Example
{
"tags": {
"TYPE": "MOONSHOT_LISTING",
"TOKEN_TICKER": "MOON",
"CONTRACT_ADDRESS": "MoonGHVU5Gy3c8yqEuHCmAUYtJtXWgr35uDYfk9pump",
"TOKEN_NAME": "Moonshot Token",
"CHAIN": "SOL"
},
"_id": "moonshot-listing-moon",
"source": "Terminal",
"title": "New Moonshot Listing: MOON",
"body": "Moonshot Token ($MOON) is now live on Moonshot",
"time": 1768853008938
}Token deployment transactions from tracked wallets. Includes deployer info, token metadata, and social links.
How to identify: tags.TRANSACTION_TYPE === "DEPLOY"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| WALLET_ADDRESS | Deployer wallet address | "abc123..." |
| WALLET_LABEL | Wallet label if set | "Dev Wallet" |
| TOKEN_ADDRESS | Token contract address | "pump..." |
| CONTRACT_ADDRESS | Token contract address | "pump..." |
| TOKEN_TICKER | Token symbol | "NEWTOKEN" |
| TOKEN_NAME | Token name | "New Token" |
| TOKEN_SUPPLY | Total supply | "1000000000" |
| TOKEN_IMAGE_URL | Token image URL | "https://..." |
| TOKEN_DESCRIPTION | Token description (optional) | "A revolutionary new token..." |
| TOKEN_TWITTER | Twitter handle (optional) | "@newtoken" |
| TOKEN_TELEGRAM | Telegram link (optional) | "https://t.me/newtoken" |
| TOKEN_WEBSITE | Website URL (optional) | "https://newtoken.xyz" |
| SOL_AMOUNT | SOL used in deployment | "0.5" |
| SOL_VALUE_USD | USD value of SOL spent | "75.00" |
| SUPPLY_PERCENTAGE | Percentage of supply bought during deploy | "1.5" |
| TRANSACTION_TYPE | Transaction type | "DEPLOY" |
| TRANSACTION_PLATFORM | Platform used | "PUMP_FUN" |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1705123456" |
Example
{
"tags": {
"CHAIN": "SOL",
"WALLET_ADDRESS": "5xYkCBkquKJ3YAFtQGJtpGLW7jSYBBpH4kYVezQpump",
"WALLET_LABEL": "Known Dev",
"TOKEN_ADDRESS": "NewTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CONTRACT_ADDRESS": "NewTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"TOKEN_TICKER": "NEWTKN",
"TOKEN_NAME": "New Token",
"TOKEN_SUPPLY": "1000000000",
"TOKEN_IMAGE_URL": "https://ipfs.io/ipfs/bafybeihfq...",
"TOKEN_DESCRIPTION": "The next generation meme token",
"TOKEN_TWITTER": "@newtoken",
"TOKEN_TELEGRAM": "https://t.me/newtoken",
"TOKEN_WEBSITE": "https://newtoken.xyz",
"SOL_AMOUNT": "0.02",
"SOL_VALUE_USD": "3.00",
"TRANSACTION_TYPE": "DEPLOY",
"TRANSACTION_PLATFORM": "PUMP_FUN",
"TRANSACTION_TIMESTAMP": "1768853008"
},
"_id": "deploy-newtkn-123",
"source": "Terminal",
"title": "🚀 [Known Dev] deployed NEWTKN",
"body": "New Token ($NEWTKN)\n0.02 SOL ($3.00)",
"time": 1768853008938
}Notifications when livestreams go live on pump.fun. Includes token info and stream details.
How to identify: tags.TYPE === "PUMPFUN_LIVESTREAM"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_LIVESTREAM" |
| CONTRACT_ADDRESS | Token contract address | "pump..." |
| CHAIN | Blockchain | "SOL" |
| PUMPFUN_URL | Pump.fun URL | "https://pump.fun/coin/..." |
| SYMBOL | Token symbol | "LIVE" |
| NAME | Token name | "Livestream Token" |
| USD_MARKET_CAP | Market cap in USD | "500000" |
| IMAGE | Thumbnail image URL (optional) | "https://..." |
| TOKEN_IMAGE | Token image URL (optional) | "https://..." |
| PAIR_ADDRESS | Pair address (optional) | "abc..." |
| DESCRIPTION | Token description (optional) | "..." |
| WEBSITE | Website URL (optional) | "https://..." |
| Twitter handle (optional) | "@token" | |
| TELEGRAM | Telegram link (optional) | "https://t.me/..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_LIVESTREAM",
"CONTRACT_ADDRESS": "LiveTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CHAIN": "SOL",
"PUMPFUN_URL": "https://pump.fun/coin/LiveTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"SYMBOL": "LIVE",
"NAME": "Livestream Token",
"USD_MARKET_CAP": "250000",
"IMAGE": "https://pump.fun/thumbnails/abc123.jpg",
"TOKEN_IMAGE": "https://ipfs.io/ipfs/bafybeihfq...",
"TWITTER": "@livestreamtoken"
},
"_id": "pumpfun-livestream-live",
"source": "Terminal",
"title": "🔴 LIVE: Livestream Token ($LIVE)",
"body": "Livestream is now live on pump.fun\nMarket Cap: $250k",
"url": "https://pump.fun/coin/LiveTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"time": 1768853008938
}Trending or highlighted tokens on pump.fun. Features tokens gaining traction.
How to identify: tags.TYPE === "PUMPFUN_HIGHLIGHT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_HIGHLIGHT" |
| CONTRACT_ADDRESS | Token contract (mint) | "pump..." |
| CHAIN | Blockchain | "SOL" |
| PUMPFUN_URL | Pump.fun coin URL | "https://pump.fun/coin/..." |
| SYMBOL | Token symbol | "TREND" |
| NAME | Token name | "Trending Token" |
| USD_MARKET_CAP | Market cap in USD | "1000000" |
| HIGHLIGHT_TITLE | Highlight description (optional) | "Top Gainer" |
| IMAGE | Token image URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_HIGHLIGHT",
"CONTRACT_ADDRESS": "TrendTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"CHAIN": "SOL",
"PUMPFUN_URL": "https://pump.fun/coin/TrendTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"SYMBOL": "TREND",
"NAME": "Trending Token",
"USD_MARKET_CAP": "1500000",
"HIGHLIGHT_TITLE": "Top Gainer 24h",
"IMAGE": "https://ipfs.io/ipfs/bafybeihfq..."
},
"_id": "pumpfun-highlight-trend",
"source": "Terminal",
"title": "⭐ Pump.fun Highlight: TREND",
"body": "Top Gainer 24h - Trending Token ($TREND)\nMarket Cap: $1.5M",
"url": "https://pump.fun/coin/TrendTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"time": 1768853008938
}Callouts from tracked pump.fun users. Shows price at callout and subsequent performance.
How to identify: tags.TYPE === "PUMPFUN_CALLOUT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_CALLOUT" |
| CONTRACT_ADDRESS | Token contract (mint) | "pump..." |
| CHAIN | Blockchain | "SOL" |
| MARKET_CAP_USD | Current market cap | "500000" |
| PUMPFUN_URL | Pump.fun coin URL | "https://pump.fun/coin/..." |
| CALLOUT_USER | User making the callout | "user123" |
| CALLOUT_PRICE | Price at time of callout | "0.0001" |
| CALLOUT_MULTIPLE | Multiple since callout | "5.2" |
| CALLOUT_MAX_PRICE_SOL | Max price reached in SOL | "0.0005" |
| SYMBOL | Token symbol (optional) | "CALL" |
| NAME | Token name (optional) | "Called Token" |
| IMAGE | Token image (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_CALLOUT",
"CONTRACT_ADDRESS": "CallTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CHAIN": "SOL",
"MARKET_CAP_USD": "750000",
"PUMPFUN_URL": "https://pump.fun/coin/CallTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CALLOUT_USER": "pumpfun_alpha",
"CALLOUT_PRICE": "0.00005",
"CALLOUT_MULTIPLE": "3.5",
"CALLOUT_MAX_PRICE_SOL": "0.000175",
"SYMBOL": "CALL",
"NAME": "Called Token"
},
"_id": "pumpfun-callout-call",
"source": "Terminal",
"title": "📢 Callout from @pumpfun_alpha: CALL",
"body": "Called Token ($CALL) - 3.5x since callout\nCurrent MC: $750k",
"url": "https://pump.fun/coin/CallTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"time": 1768853008938
}Published articles from pump.fun. Includes article details and associated token.
How to identify: tags.TYPE === "PUMPFUN_ARTICLE_PUBLISHED"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_ARTICLE_PUBLISHED" |
| DOCUMENT_ID | Article document ID | "abc123..." |
| CONTRACT_ADDRESS | Token contract (optional) | "pump..." |
| CHAIN | Blockchain (optional) | "SOL" |
| PUMPFUN_URL | Pump.fun URL (optional) | "https://pump.fun/..." |
| HEADLINE | Article headline (optional) | "New Token Analysis" |
| PREVIEW | Article preview text (optional) | "In this article we explore..." |
| SYMBOL | Token symbol (optional) | "ART" |
| NAME | Token name (optional) | "Article Token" |
| IMAGE | Token image URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_ARTICLE_PUBLISHED",
"DOCUMENT_ID": "article-doc-123456",
"CONTRACT_ADDRESS": "ArtTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CHAIN": "SOL",
"PUMPFUN_URL": "https://pump.fun/articles/article-doc-123456",
"HEADLINE": "Deep Dive: The Rise of Meme Tokens",
"PREVIEW": "In this comprehensive analysis, we explore the factors driving...",
"SYMBOL": "MEME",
"NAME": "Meme Token"
},
"_id": "pumpfun-article-123456",
"source": "Terminal",
"title": "📰 Pump.fun Article: Deep Dive: The Rise of Meme Tokens",
"body": "In this comprehensive analysis, we explore the factors driving...",
"url": "https://pump.fun/articles/article-doc-123456",
"time": 1768853008938
}Fee claims from tracked BAGS tokens. Shows who claimed fees and their role.
How to identify: tags.TYPE === "BAGS_FEE_CLAIM"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "BAGS_FEE_CLAIM" |
| CONTRACT_ADDRESS | Token contract address | "pump..." |
| TOKEN_SYMBOL | Token symbol | "BAGS" |
| CLAIMER_WALLET | Claimer wallet address | "abc123..." |
| CLAIMER_TWITTER | Claimer Twitter handle | "@claimer" |
| CLAIMER_ROLE | Role (creator or royalty recipient) | "creator" |
| ROYALTY_PERCENTAGE | Royalty percentage (0-100) | "5" |
| SOL_AMOUNT | SOL amount claimed | "1.5" |
| TRANSACTION_ID | Transaction signature | "abc..." |
| CHAIN | Blockchain | "SOL" |
| IS_FIRST_CLAIM | Whether this is the first fee claim | "true" / "false" |
Example
{
"tags": {
"TYPE": "BAGS_FEE_CLAIM",
"CONTRACT_ADDRESS": "BagsTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"TOKEN_SYMBOL": "BAGS",
"CLAIMER_WALLET": "5xYkCBkquKJ3YAFtQGJtpGLW7jSYBBpH4kYVezQpump",
"CLAIMER_TWITTER": "@bags_creator",
"CLAIMER_ROLE": "creator",
"ROYALTY_PERCENTAGE": "5",
"SOL_AMOUNT": "2.5",
"TRANSACTION_ID": "5nYkCBkquKJ3YAFtQGJtpGLW7jSYBBpH4kYVezQtxsig",
"CHAIN": "SOL",
"IS_FIRST_CLAIM": "false"
},
"_id": "bags-fee-claim-123",
"source": "Terminal",
"title": "💰 BAGS Fee Claim: @bags_creator claimed 2.5 SOL",
"body": "Creator claimed 2.5 SOL from BAGS token fees (5% royalty)",
"time": 1768853008938
}New subdomains discovered for monitored websites.
How to identify: tags.TYPE === "NEW_SUBDOMAIN"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEW_SUBDOMAIN" |
| SUBDOMAIN | Full subdomain name | "api.example.com" |
| DOMAIN | Base domain | "example.com" |
Example
{
"tags": {
"TYPE": "NEW_SUBDOMAIN",
"SUBDOMAIN": "api.project.xyz",
"DOMAIN": "project.xyz"
},
"_id": "subdomain-api-project",
"source": "Terminal",
"title": "🌐 New subdomain: api.project.xyz",
"body": "New subdomain discovered for project.xyz",
"url": "https://api.project.xyz",
"time": 1768853008938
}Content or status changes detected on monitored website URLs.
How to identify: tags.TYPE === "URL_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "URL_CHANGE" |
| PREVIOUS_STATUS | Previous HTTP status code | "200" |
| CURRENT_STATUS | Current HTTP status code | "301" |
| REMOVED | Removed content (pipe-separated) | "old text|more old" |
| ADDED | Added content (pipe-separated) | "new text|more new" |
| CHANGE_PERCENTAGE | Percentage of content changed | "15.5" |
| CONTRACT_ADDRESS | CA found in added content (optional) | "pump..." |
| CHAIN | Blockchain if CA found (optional) | "SOL" |
Example
{
"tags": {
"TYPE": "URL_CHANGE",
"PREVIOUS_STATUS": "200",
"CURRENT_STATUS": "200",
"REMOVED": "Coming Soon|Q1 2024",
"ADDED": "Live Now|Mint Address: abc123pump",
"CHANGE_PERCENTAGE": "12.5",
"CONTRACT_ADDRESS": "abc123pump",
"CHAIN": "SOL"
},
"_id": "url-change-project",
"source": "Terminal",
"title": "📝 Website changed: project.xyz",
"body": "12.5% content changed\n+ Live Now, Mint Address: abc123pump\n- Coming Soon, Q1 2024",
"url": "https://project.xyz",
"time": 1768853008938
}Triggered when a tracked account changes their website URL in their profile.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "WEBSITE_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "WEBSITE_CHANGE" |
| AUTHOR_ID | User ID | "210297577" |
| AUTHOR_HANDLE | Username | "tekkaadan" |
| AUTHOR_NAME | Display name | "tekkaadan" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1288493134000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "3422" |
| AUTHOR_BIO | Bio | "AI App: https://t.co/..." |
| AUTHOR_LOCATION | Location | "Dark Continent" |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| OLD_WEBSITE | Previous website URL | "http://litcoin.tech" |
| NEW_WEBSITE | New website URL | "http://litcoin.app" |
| CONTRACT_ADDRESS | CA extracted from new website (optional) | "pump..." |
| CHAIN | Blockchain if CA found (optional) | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "WEBSITE_CHANGE",
"AUTHOR_ID": "210297577",
"AUTHOR_HANDLE": "tekkaadan",
"AUTHOR_NAME": "tekkaadan",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2011532017687834624/CkeXR-KM_normal.jpg",
"AUTHOR_CREATED_AT": "1288493134000",
"AUTHOR_FOLLOWERS_COUNT": "3422",
"AUTHOR_BIO": "AI App: https://t.co/91GVyPNjwx | @litcoin_AI Previous @ocswap | @hinataio | @amplifytracker AI x Artist NFTs: @kawaaii_xyz TG: @tekkaadan",
"AUTHOR_LOCATION": "Dark Continent",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/210297577/1612601393",
"AUTHOR_WEBSITE": "http://litcoin.app",
"OLD_WEBSITE": "http://litcoin.tech",
"NEW_WEBSITE": "http://litcoin.app",
"SOURCE_URL": "https://x.com/tekkaadan",
"CATEGORY": "CUSTOM"
},
"_id": "tekkaadan-TWITTER_WEBSITE_CHANGE",
"source": "Terminal",
"title": "🌐 tekkaadan (@tekkaadan) updated website",
"body": "Old: http://litcoin.tech\n\nNew: http://litcoin.app",
"icon": "https://pbs.twimg.com/profile_images/2011532017687834624/CkeXR-KM_normal.jpg",
"url": "https://x.com/tekkaadan",
"time": 1775933539318
}Triggered when a tracked account changes their location in their profile.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "LOCATION_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "LOCATION_CHANGE" |
| AUTHOR_ID | User ID | "1469380022213488646" |
| AUTHOR_HANDLE | Username | "guneysol" |
| AUTHOR_NAME | Display name | "Guney" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1639162483000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "3469" |
| AUTHOR_BIO | Bio | "building @helius / prev. winner @colosseum, @uwaterloo" |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| OLD_LOCATION | Previous location (empty string if none) | "" |
| NEW_LOCATION | New location | "ca t" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "LOCATION_CHANGE",
"AUTHOR_ID": "1469380022213488646",
"AUTHOR_HANDLE": "guneysol",
"AUTHOR_NAME": "Guney",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1856821941954301952/Dvvxfada_normal.jpg",
"AUTHOR_CREATED_AT": "1639162483000",
"AUTHOR_FOLLOWERS_COUNT": "3469",
"AUTHOR_BIO": "building @helius / prev. winner @colosseum, @uwaterloo",
"AUTHOR_LOCATION": "ca t",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/1469380022213488646/1743716373",
"OLD_LOCATION": "",
"NEW_LOCATION": "ca t",
"SOURCE_URL": "https://x.com/guneysol",
"CATEGORY": "CUSTOM"
},
"_id": "guneysol-TWITTER_LOCATION_CHANGE",
"source": "Terminal",
"title": "📍 Guney (@guneysol) updated location",
"body": "Old: (empty)\n\nNew: ca t",
"icon": "https://pbs.twimg.com/profile_images/1856821941954301952/Dvvxfada_normal.jpg",
"url": "https://x.com/guneysol",
"time": 1775934293556
}Triggered when a tracked account adds or removes an organizational affiliation badge (e.g., affiliated with @xai, @Polymarket).
How to identify: tags.TYPE === "PROFILE" && (tags.SUBTYPE === "AFFILIATE_ADDED" || tags.SUBTYPE === "AFFILIATE_REMOVED")
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Affiliate added or removed | "AFFILIATE_ADDED" / "AFFILIATE_REMOVED" |
| AUTHOR_ID | User ID | "45959829" |
| AUTHOR_HANDLE | Username | "timeyoutakeit" |
| AUTHOR_NAME | Display name | "Amy" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1244585521000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "2580" |
| AUTHOR_FOLLOWING_COUNT | Following count | "1018" |
| AUTHOR_BIO | Bio | "Everything docs. product @GoogleDeepmind" |
| AUTHOR_LOCATION | Location | " 🇮🇪 " |
| AUTHOR_WEBSITE | Website | "https://..." |
| AUTHOR_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Blue verified status | "true" |
| AUTHOR_AFFILIATE_DESCRIPTION | Affiliate org name on author profile | "Google AI Studio" |
| ORG_HANDLE | Organization handle | "GoogleAIStudio" |
| ORG_NAME | Organization display name | "Google AI Studio" |
| ORG_ID | Organization user ID | "1742923424056713217" |
| ORG_ICON | Organization avatar URL | "https://pbs.twimg.com/..." |
| ORG_BIO | Organization bio | "The fastest path from prompt to prototype..." |
| ORG_BANNER | Organization banner URL | "https://pbs.twimg.com/profile_banners/..." |
| ORG_LOCATION | Organization location | "It's time to build" |
| ORG_WEBSITE | Organization website | "https://ai.studio/build" |
| ORG_FOLLOWERS_COUNT | Organization follower count | "153626" |
| ORG_FOLLOWING_COUNT | Organization following count | "2" |
| ORG_VERIFIED_TYPE | Organization verification type | "business" |
| ORG_CREATED_AT | Organization account creation date | "1704380306000" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "AFFILIATE_ADDED",
"AUTHOR_ID": "45959829",
"AUTHOR_HANDLE": "timeyoutakeit",
"AUTHOR_NAME": "Amy",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/378800000299560643/4bf4c4477bd330523108cdaeaf7c7731_normal.jpeg",
"AUTHOR_CREATED_AT": "1244585521000",
"AUTHOR_FOLLOWERS_COUNT": "2580",
"AUTHOR_FOLLOWING_COUNT": "1018",
"AUTHOR_BIO": "Everything docs. \n\nproduct @GoogleDeepmind\nPrev @vercel, @GitHub, @microsoft, @xamarinhq\n\nNone of my opinions are my own.",
"AUTHOR_LOCATION": " 🇮🇪 ",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_BANNER": "https://pbs.twimg.com/profile_banners/45959829/1705256452",
"AUTHOR_AFFILIATE_DESCRIPTION": "Google AI Studio",
"ORG_HANDLE": "GoogleAIStudio",
"ORG_NAME": "Google AI Studio",
"ORG_ID": "1742923424056713217",
"ORG_ICON": "https://pbs.twimg.com/profile_images/1957558782067896323/6jXpPKD4_normal.png",
"ORG_BIO": "The fastest path from prompt to prototype to production with Gemini",
"ORG_BANNER": "https://pbs.twimg.com/profile_banners/1742923424056713217/1773068211",
"ORG_LOCATION": "It's time to build",
"ORG_WEBSITE": "https://ai.studio/build",
"ORG_FOLLOWERS_COUNT": "153626",
"ORG_VERIFIED_TYPE": "business",
"ORG_CREATED_AT": "1704380306000",
"SOURCE_URL": "https://x.com/timeyoutakeit"
},
"_id": "timeyoutakeit-TWITTER_AFFILIATE_CHANGE-AFFILIATE_ADDED-googleaistudio",
"source": "Terminal",
"title": "🏢 @timeyoutakeit (Amy) affiliated with @GoogleAIStudio (Google AI Studio)",
"body": "\n\n📝 Everything docs. \n\nproduct @GoogleDeepmind\nPrev @vercel, @GitHub, @microsoft, @xamarinhq\n\nNone of my opinions are my own.\n\n👥 2580 followers\n📍 🇮🇪 ",
"icon": "https://pbs.twimg.com/profile_images/378800000299560643/4bf4c4477bd330523108cdaeaf7c7731_normal.jpeg",
"url": "https://x.com/timeyoutakeit",
"time": 1775501804056,
"image": "https://pbs.twimg.com/profile_banners/45959829/1705256452"
}Triggered when a tracked account pins, unpins, or changes their pinned tweet. This unified type combines old pin and new pin information in a single event.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "PINNED_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "PINNED_CHANGE" |
| AUTHOR_ID | User ID | "779657810405654528" |
| AUTHOR_HANDLE | Username | "TehranTimes79" |
| AUTHOR_NAME | Display name | "Tehran Times" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| OLD_TWEET_ID | ID of previously pinned tweet (if any) | "2042666182533169341" |
| OLD_TWEET_LINK | Link to previously pinned tweet | "https://x.com/TehranTimes79/status/..." |
| OLD_TWEET_TEXT | Content of previously pinned tweet | "Tomorrow's edition of the Tehran Times..." |
| OLD_TWEET_TEXT_TRANSLATED | Translated old tweet | "Translated old content..." |
| OLD_IMAGE | Image from old pinned tweet | "https://pbs.twimg.com/media/..." |
| OLD_VIDEO | Video from old pinned tweet | "https://video.twimg.com/..." |
| OLD_VIDEO_THUMBNAIL | Thumbnail for old video | "https://pbs.twimg.com/..." |
| OLD_IMAGE2 / OLD_IMAGE3 / OLD_IMAGE4 | Additional images from old pinned tweet | "https://pbs.twimg.com/media/..." |
| OLD_CONTRACT_ADDRESS | CA in old pinned tweet | "oldCA123pump" |
| OLD_CHAIN | Chain for old CA | "SOL" |
| NEW_TWEET_ID | ID of newly pinned tweet (if any) | "2043033840940105785" |
| NEW_TWEET_LINK | Link to newly pinned tweet | "https://x.com/TehranTimes79/status/..." |
| NEW_TWEET_TEXT | Content of newly pinned tweet | "Tomorrow's edition of the Tehran Times..." |
| NEW_TWEET_TEXT_TRANSLATED | Translated new tweet (if applicable) | "Translated content..." |
| NEW_IMAGE | Image from new pinned tweet | "https://pbs.twimg.com/media/..." |
| NEW_IMAGE2 / NEW_IMAGE3 / NEW_IMAGE4 | Additional images from new pinned tweet | "https://pbs.twimg.com/media/..." |
| NEW_VIDEO | Video from new pinned tweet | "https://video.twimg.com/..." |
| NEW_VIDEO_THUMBNAIL | Thumbnail for new video | "https://pbs.twimg.com/..." |
| NEW_CONTRACT_ADDRESS | CA in new pinned tweet | "abc123pump" |
| NEW_CHAIN | Chain for new CA | "SOL" |
| CONTRACT_ADDRESS | Detected contract address | "abc123pump" |
| CHAIN | Blockchain of contract | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "PINNED_CHANGE",
"AUTHOR_ID": "779657810405654528",
"AUTHOR_HANDLE": "TehranTimes79",
"AUTHOR_NAME": "Tehran Times",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1794657140755386368/6gwo_pyC_normal.jpg",
"OLD_TWEET_ID": "2042666182533169341",
"OLD_TWEET_LINK": "https://x.com/TehranTimes79/status/2042666182533169341",
"OLD_TWEET_TEXT": "Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth",
"OLD_IMAGE": "https://pbs.twimg.com/media/HFkCDDKakAEOLOt.jpg",
"NEW_TWEET_ID": "2043033840940105785",
"NEW_TWEET_LINK": "https://x.com/TehranTimes79/status/2043033840940105785",
"NEW_TWEET_TEXT": "Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth",
"NEW_IMAGE": "https://pbs.twimg.com/media/HFpQcXJb0AAL8I0.jpg",
"SOURCE_URL": "https://x.com/TehranTimes79/status/2043033840940105785",
"CATEGORY": "CUSTOM"
},
"_id": "tehrantimes79-TWITTER_PINNED_CHANGE-2043033840940105785",
"source": "Terminal",
"title": "📌 @TehranTimes79 changed pinned tweet",
"body": "Old: Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth\n\nNew: Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth",
"icon": "https://pbs.twimg.com/profile_images/1794657140755386368/6gwo_pyC_normal.jpg",
"url": "https://x.com/TehranTimes79/status/2043033840940105785",
"time": 1775932226219,
"image": "https://pbs.twimg.com/media/HFpQcXJb0AAL8I0.jpg",
"info": {
"twitterId": "779657810405654528",
"isReply": false,
"isSelfReply": false,
"isRetweet": false,
"isQuote": false,
"profileChange": {
"field": "pinned",
"before": "https://x.com/TehranTimes79/status/2042666182533169341",
"after": "https://x.com/TehranTimes79/status/2043033840940105785"
}
}
}New Moltbook AI agent creations tracked by the system.
How to identify: tags.TYPE === "MOLTBOOK_AGENT_CREATION"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "MOLTBOOK_AGENT_CREATION" |
| AGENT_NAME | Name of the AI agent | "TradingBot" |
| AGENT_URL | URL to the agent | "https://moltbook.com/agent/..." |
| AUTHOR_HANDLE | Creator's Twitter handle | "@creator" |
| AUTHOR_NAME | Creator's display name | "Agent Creator" |
| AUTHOR_URL | Creator's profile URL | "https://x.com/creator" |
| AUTHOR_BIO | Creator's bio | "Building AI agents" |
| AUTHOR_LOCATION | Creator's location | "San Francisco" |
| AUTHOR_PROFILE_IMAGE | Creator's avatar | "https://pbs.twimg.com/..." |
| AUTHOR_BANNER | Creator's banner image | "https://pbs.twimg.com/..." |
| FOLLOWER_COUNT | Creator's follower count | "50000" |
| TWEET_ID | Associated tweet ID | "1234567890" |
| TWEET_TEXT | Tweet content | "Launching my new agent..." |
| AUTHOR_TWITTER_ID | Creator's Twitter user ID | "123456789" |
| TWEET_URL | Link to tweet | "https://x.com/.../status/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "MOLTBOOK_AGENT_CREATION",
"AGENT_NAME": "AlphaTrader",
"AGENT_URL": "https://moltbook.com/agent/alpha-trader",
"AUTHOR_HANDLE": "@crypto_dev",
"AUTHOR_NAME": "Crypto Developer",
"AUTHOR_URL": "https://x.com/crypto_dev",
"AUTHOR_BIO": "Building the future of trading",
"AUTHOR_PROFILE_IMAGE": "https://pbs.twimg.com/profile_images/...",
"FOLLOWER_COUNT": "25000",
"AUTHOR_TWITTER_ID": "987654321",
"TWEET_ID": "1234567890123456789",
"TWEET_TEXT": "Just launched my new AI trading agent on Moltbook!",
"TWEET_URL": "https://x.com/crypto_dev/status/1234567890123456789"
},
"_id": "moltbook-agent-alpha-trader",
"source": "Terminal",
"title": "🤖 New Moltbook Agent: AlphaTrader by @crypto_dev",
"body": "Just launched my new AI trading agent on Moltbook!\n\n👥 25000 followers",
"url": "https://moltbook.com/agent/alpha-trader",
"time": 1768853008938
}New videos from tracked YouTube channels.
How to identify: tags.TYPE === "NEW_YOUTUBE_VIDEO"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEW_YOUTUBE_VIDEO" |
| CHANNEL_ID | YouTube channel ID | "UCxxxxxxxxxx" |
| VIDEO_TITLE | Title of the video | "Market Analysis 2024" |
| VIDEO_SUMMARY | AI-generated summary | "This video covers..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "NEW_YOUTUBE_VIDEO",
"CHANNEL_ID": "UCxxxxxxxxxx",
"VIDEO_TITLE": "Crypto Market Analysis - Weekly Update",
"VIDEO_SUMMARY": "In this video, we analyze the latest market trends, including Bitcoin's price action and key altcoin movements."
},
"_id": "youtube-video-abc123",
"source": "Terminal",
"title": "📺 New Video: Crypto Market Analysis - Weekly Update",
"body": "In this video, we analyze the latest market trends...",
"url": "https://youtube.com/watch?v=abc123",
"time": 1768853008938
}Transcript availability for tracked YouTube videos.
How to identify: tags.TYPE === "NEW_YOUTUBE_VIDEO_TRANSCRIPT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEW_YOUTUBE_VIDEO_TRANSCRIPT" |
| CHANNEL_ID | YouTube channel ID | "UCxxxxxxxxxx" |
| VIDEO_TITLE | Title of the video | "Market Analysis 2024" |
| VIDEO_SUMMARY | Summary of transcript content | "Key points discussed..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "NEW_YOUTUBE_VIDEO_TRANSCRIPT",
"CHANNEL_ID": "UCxxxxxxxxxx",
"VIDEO_TITLE": "Crypto Market Analysis - Weekly Update",
"VIDEO_SUMMARY": "Key points: Bitcoin consolidating at $50k, Ethereum upgrade incoming, altseason indicators present."
},
"_id": "youtube-transcript-abc123",
"source": "Terminal",
"title": "📝 Transcript: Crypto Market Analysis - Weekly Update",
"body": "Key points: Bitcoin consolidating at $50k, Ethereum upgrade incoming, altseason indicators present.",
"url": "https://youtube.com/watch?v=abc123",
"time": 1768853008938
}Base URL
https://news.bark.ggAuthentication
All requests require your API key in the X-API-KEY header:
X-API-KEY: <your api key>Path Parameters
category - Category name (e.g., CUSTOM, WHALES)Example Request
curl -X GET "https://news.bark.gg/settings/twitter/categories/CUSTOM" \ -H "X-API-KEY: YOUR_API_KEY"
Example Response
{
"accounts": {
"elonmusk": {
"label": "Tesla CEO",
"monitorTweets": true,
"monitorReplies": false,
"monitorQuotes": true,
"monitorRetweets": false,
"monitorProfileChanges": true,
"monitorFollows": false,
"monitorDeletedTweets": true,
"imagesOnly": false
}
}
}Path Parameters
category - Category name. Use CUSTOM to add new accounts. System categories only allow updating existing accounts.handle - Twitter handle (without @) or Twitter user IDQuery Parameters (all optional)
label - Custom label for the accountcontractAddress - Associated token contract addressmonitorTweets - Track tweets (true/false)monitorReplies - Track replies (true/false)monitorQuotes - Track quote tweets (true/false)monitorRetweets - Track retweets (true/false)imagesOnly - Only track tweets with images (true/false)monitorProfileChanges - Track bio/name/avatar changes (true/false)monitorFollows - Track follow/unfollow events (true/false)monitorDeletedTweets - Track deleted tweets (true/false)If a toggle parameter is omitted, the category default is used for new accounts, or the existing value is kept for updates.
Example Request
curl -X PUT "https://news.bark.gg/settings/twitter/categories/CUSTOM/elonmusk?label=Tesla%20CEO&monitorReplies=true&monitorDeletedTweets=true" \ -H "X-API-KEY: YOUR_API_KEY"
Response
Returns 200 OK on success with no body. Returns 403 Forbidden if attempting to add a new account to a system category.
Path Parameters
category - Must be CUSTOM. System categories do not allow account removal.handle - Twitter handle (without @) or Twitter user IDExample Request
curl -X DELETE "https://news.bark.gg/settings/twitter/categories/CUSTOM/elonmusk" \ -H "X-API-KEY: YOUR_API_KEY"
Response
Returns 200 OK on success with no body. Returns 403 Forbidden if attempting to remove from a system category.
Example Request
curl -X POST "https://news.bark.gg/settings/twitter/reset" \ -H "X-API-KEY: YOUR_API_KEY"
Response
Returns 200 OK on success with no body.
Example Request
curl -X GET "https://news.bark.gg/settings/warpcast/accounts" \ -H "X-API-KEY: YOUR_API_KEY"
Example Response
{
"accounts": {
"vitalik": {
"discordTagRoleId": null,
"addedAt": "2026-03-15T10:00:00Z"
},
"dwr": {
"discordTagRoleId": "123456789",
"addedAt": "2026-03-10T08:30:00Z"
}
}
}Path Parameters
username - Farcaster username (without @)Example Request
curl -X PUT "https://news.bark.gg/settings/warpcast/accounts/vitalik" \ -H "X-API-KEY: YOUR_API_KEY"
Response
Returns 200 OK on success with no body. Returns 409 Conflict if the account is already tracked.
Path Parameters
username - Farcaster username (without @)Example Request
curl -X DELETE "https://news.bark.gg/settings/warpcast/accounts/vitalik" \ -H "X-API-KEY: YOUR_API_KEY"
Response
Returns 200 OK on success with no body. Returns 400 Bad Request if the account is not tracked.
Important
Add the Bot to Your Group
Click the button below to add the Bark bot to your Telegram group chat:
Sign in to pre-fill your API key in the link above. Otherwise, after adding the bot to your group, run /start <your api key> using the key from the Account page.
Configure Settings
Use /track and /untrack commands to start tracking Twitter accounts, wallets, websites or domains.
You can also configure settings on the Settings page
Add Admins (optional)
As the subscription holder you can do everything yourself. If you want to let others in the group track/untrack things and configure settings, grant them admin access:
/add_admin @username