Setup Guide

Choose your preferred platform to receive your customized Bark news feed

Website
FREE
PUP
DOGGO
TOP DOG
View your customized news feed directly on the Bark website.
1

Open the Feed

Navigate to the News page to view your feed

2

Customize Your Feed

Configure what you want to track on the Settings page

Telegram
PUP
DOGGO
TOP DOG
Receive your customized news feed in Telegram in real-time.
1

Find the Bark Bot

Open @BarkFeedBot in Telegram

2

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

3

Customize Your Feed

Configure what you want to track on the Settings page

Discord (Individual)
PUP
DOGGO
TOP DOG
Receive your customized news feed in Discord in real-time via direct messages.
1

Install the Bark Bot

Click the button below to install the Bark bot to your Discord account:

2

Configure Settings

Use /twitter track/untrack, /wallet track/untrack, etc. to configure what to track.

You can also configure settings on the Settings page

Discord (Group)
BASIC
PRO
ULTRA
Set up Bark for your Discord server.
1

Add the Bot to Your Server

Click the button below to add the Bark bot to your Discord server:

2

Run /setup Command

In your Discord server, run the /setup command to:

  1. Activate your subscription
  2. Configure who can manage the feed settings
3

Configure Settings

Use /twitter track/untrack, /wallet track/untrack, etc. to configure what to track.

You can also configure settings on the Settings page

Tree Terminal
DOGGO
TOP DOG
Integrate your Bark feed into Tree Terminal to receive your feed in real-time.
1

Configure WebSocket Connection

In Tree Terminal, go to Settings → News and set the following fields:

URL: wss://news.bark.gg/ws
Login message: login <your api key>
Leave other fields unchanged

You can find your API key on the Account page

2

Customize Your Feed

Configure what you want to track on the Settings page

PvP Terminal
DOGGO
TOP DOG
Connect your Bark feed to PvP Terminal to receive your feed in real-time.
1

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

2

Enable the News Feed

Go to Scrapers → Bark News and enable:

  • Feed
  • Notifications
  • Audio
3

Customize Your Feed

Configure what you want to track on the Settings page

Tuleep Terminal
DOGGO
TOP DOG
Connect your Bark feed to Tuleep Terminal to receive your feed in real-time.
1

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

3

Customize Your Feed

Configure what you want to track on the Settings page

Tealstreet Terminal
DOGGO
TOP DOG
Connect your Bark feed to Tealstreet Terminal to receive your feed in real-time.
1

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

3

Customize Your Feed

Configure what you want to track on the Settings page

API
DOGGO
TOP DOG
Connect to Bark programmatically via WebSocket or REST API.
WebSocket Connection
Real-time streaming feed via WebSocket.
1

Connect to WebSocket

Establish a WebSocket connection to the following URL:

wss://news.bark.gg/ws
2

Authenticate

After connecting, send the following message to authenticate:

login <your api key>

You can find your API key on the Account page

3

Customize Your Feed

Configure what you want to track on the Settings page

Message Format Reference
Comprehensive documentation of all WebSocket message types and their data structures

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 identifier
  • source - Source system
  • title - Human-readable title
  • body - Human-readable body
  • url - Primary URL
  • icon - Icon URL
  • image - Image URL
  • time - Unix timestamp (ms)
  • tags - Structured data
  • info - Additional metadata
  • show_feed - Show in feed
  • show_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 found
  • PREFERRED_TRADING_URL — User's preferred trading platform URL (suffixed _2, _3 for 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

TagDescriptionExample
TYPEEvent category"TWEET"
SUBTYPEEvent type"NEW_TWEET"
AUTHOR_IDTwitter user ID"24809221"
AUTHOR_HANDLETwitter username"kaiynne"
AUTHOR_NAMEDisplay name"kain.crates"
AUTHOR_ICONProfile picture URL"https://pbs.twimg.com/..."
TWEET_IDTweet ID"2013337305461989526"
TWEET_TEXTTweet content (null for RTs)"We did this airdrop..."
TWEET_TEXT_TRANSLATEDTranslation if non-English"... [Translated]"
TWEET_LINKURL to tweet"https://x.com/kaiynne/status/..."
SOURCE_URLURL to the source (same as TWEET_LINK)"https://x.com/..."
IMAGE / IMAGE2 / IMAGE3 / IMAGE4Attached image URLs (includes link preview images when no media is attached)"https://pbs.twimg.com/media/..."
VIDEO / VIDEO2 / VIDEO3 / VIDEO4Video URLs if present"https://video.twimg.com/..."
VIDEO_THUMBNAIL / VIDEO_THUMBNAIL2 / VIDEO_THUMBNAIL3Thumbnails for videos"https://pbs.twimg.com/..."
LINK_PREVIEW_TITLETitle from URL embed (OpenGraph)"Stock market today: Dow soars 1,000 points"
LINK_PREVIEW_DESCRIPTIONDescription from URL embed (OpenGraph)"Stocks turned sharply higher on Tuesday..."
LINK_PREVIEW_IMAGEImage from URL embed (OpenGraph)"https://s.yimg.com/ny/api/res/..."
IS_REPLYIs this a reply"true" / "false"
IS_QUOTEIs this a quote tweet"true" / "false"
IS_RETWEETIs this a retweet"true" / "false"
IS_SELF_REPLYReplying to own tweet"true" / "false"
REPLY_AUTHOR_HANDLEUsername of replied-to user"katexbt"
REPLY_AUTHOR_NAMEName of replied-to user"katexbt.hl"
REPLY_AUTHOR_ICONAvatar of replied-to user"https://pbs.twimg.com/..."
REPLY_TWEET_IDID of replied-to tweet"2013104553449660797"
REPLY_TWEET_TEXTContent of replied-to tweet"If Infinex doesn't..."
REPLY_TWEET_TEXT_TRANSLATEDTranslation of replied-to tweet if non-English"... [Translated]"
REPLY_IMAGEImage in replied-to tweet (includes link preview images when no media is attached)"https://pbs.twimg.com/media/..."
REPLY_VIDEOVideo in replied-to tweet"https://video.twimg.com/..."
REPLY_VIDEO_THUMBNAILThumbnail for reply video"https://pbs.twimg.com/..."
REPLY_LINK_PREVIEW_TITLETitle from URL embed in replied-to tweet"Article headline..."
REPLY_LINK_PREVIEW_DESCRIPTIONDescription from URL embed in replied-to tweet"Article summary..."
REPLY_LINK_PREVIEW_IMAGEImage from URL embed in replied-to tweet"https://..."
QUOTED_AUTHOR_HANDLEUsername of quoted user"infinex"
QUOTED_AUTHOR_NAMEName of quoted user"Infinex"
QUOTED_AUTHOR_ICONAvatar of quoted user"https://pbs.twimg.com/..."
QUOTED_TWEET_IDID of quoted tweet"2013070582989111541"
QUOTED_TWEET_TEXTContent of quoted tweet"INX Token Generation..."
QUOTED_TWEET_TEXT_TRANSLATEDTranslation of quoted tweet if non-English"... [Translated]"
QUOTED_IMAGEImage in quoted tweet (includes link preview images when no media is attached)"https://pbs.twimg.com/media/..."
QUOTED_VIDEOVideo in quoted tweet"https://video.twimg.com/..."
QUOTED_VIDEO_THUMBNAILThumbnail for quoted video"https://pbs.twimg.com/..."
QUOTED_LINK_PREVIEW_TITLETitle from URL embed in quoted tweet"Article headline..."
QUOTED_LINK_PREVIEW_DESCRIPTIONDescription from URL embed in quoted tweet"Article summary..."
QUOTED_LINK_PREVIEW_IMAGEImage from URL embed in quoted tweet"https://..."
RETWEET_AUTHOR_HANDLEUsername of retweeted user"elonmusk"
RETWEET_AUTHOR_NAMEName of retweeted user"Elon Musk"
RETWEET_AUTHOR_ICONAvatar of retweeted user"https://pbs.twimg.com/..."
RETWEET_AUTHOR_IDUser ID of retweeted user"44196397"
RETWEET_TWEET_IDID of retweeted tweet"2013070582989111541"
RETWEET_TWEET_TEXTContent of retweeted tweet"Original tweet content..."
RETWEET_TWEET_TEXT_TRANSLATEDTranslation of retweeted tweet if non-English"... [Translated]"
RETWEET_IMAGEImage in retweeted tweet (includes link preview images when no media is attached)"https://pbs.twimg.com/media/..."
RETWEET_VIDEOVideo in retweeted tweet"https://video.twimg.com/..."
RETWEET_VIDEO_THUMBNAILThumbnail for retweet video"https://pbs.twimg.com/..."
RETWEET_LINK_PREVIEW_TITLETitle from URL embed in retweeted tweet"Article headline..."
RETWEET_LINK_PREVIEW_DESCRIPTIONDescription from URL embed in retweeted tweet"Article summary..."
RETWEET_LINK_PREVIEW_IMAGEImage from URL embed in retweeted tweet"https://..."
AUTHOR_FOLLOWERS_COUNTTweet author's follower count"128274"
QUOTED_AUTHOR_FOLLOWERS_COUNTQuoted tweet author's follower count"500000"
RETWEET_AUTHOR_FOLLOWERS_COUNTRetweeted author's follower count"1000000"
REPLY_AUTHOR_FOLLOWERS_COUNTParent tweet author's follower count"250000"
CONTRACT_ADDRESSDetected token contract address"8HxW9Z3YT1gXgQ...pump"
CHAINBlockchain if CA detected"SOL" / "ETHEREUM"
PREFERRED_TRADING_URLBest trading URL"https://photon-sol.tinyastro.io/..."
LABELAccount label if set"Infinex CEO, $MEC"
CATEGORYAccount category"AD_HOC" / "CUSTOM"
AUTHOR_BIOAuthor's Twitter bio"Building cool stuff"
AUTHOR_CREATED_ATAuthor's account creation date"2012-03-15T..."
AUTHOR_LOCATIONAuthor's location"San Francisco"
AUTHOR_PROFILE_BANNERAuthor's banner image URL"https://pbs.twimg.com/profile_banners/..."
AUTHOR_WEBSITEAuthor's website"https://example.com"
AUTHOR_IS_BLUE_VERIFIEDWhether the author has a blue checkmark"true"
AUTHOR_VERIFIED_TYPEAuthor's verification type"Business" / "Government"
AUTHOR_AFFILIATE_DESCRIPTIONAuthor's affiliate badge description"BAGS"
AUTHOR_AFFILIATE_BADGE_URLAuthor's affiliate badge image URL"https://pbs.twimg.com/..."
AUTHOR_AFFILIATE_URLAuthor's affiliate link URL"https://example.com"
AUTHOR_AFFILIATE_LABEL_TYPEAuthor's affiliate label type"BusinessLabel"
IS_ARTICLEWhether the tweet is a Twitter article (long-form content)"true"
REPLY_IS_ARTICLE / QUOTED_IS_ARTICLE / RETWEET_IS_ARTICLEWhether the sub-tweet is a Twitter article"true"
ARTICLE_TITLEArticle title (only when IS_ARTICLE is true)"My Article Title"
ARTICLE_TEXTArticle body text (only when IS_ARTICLE is true)"Full article content..."
ARTICLE_BANNERArticle cover/banner image URL (only when IS_ARTICLE is true)"https://pbs.twimg.com/media/..."
ARTICLE_IMAGE2 / ARTICLE_IMAGE3 / ... / ARTICLE_IMAGENAdditional article images beyond the banner (only when IS_ARTICLE is true)"https://pbs.twimg.com/media/..."
ARTICLE_VIDEO2 / ARTICLE_VIDEO3 / ... / ARTICLE_VIDEONAdditional article videos beyond the banner (only when IS_ARTICLE is true)"https://video.twimg.com/..."
REPLY_ARTICLE_TITLE / QUOTED_ARTICLE_TITLE / RETWEET_ARTICLE_TITLEArticle title of sub-tweet (only when sub-tweet IS_ARTICLE is true)"Article Title"
REPLY_ARTICLE_TEXT / QUOTED_ARTICLE_TEXT / RETWEET_ARTICLE_TEXTArticle body text of sub-tweet"Full article content..."
REPLY_ARTICLE_BANNER / QUOTED_ARTICLE_BANNER / RETWEET_ARTICLE_BANNERArticle banner image of sub-tweet"https://pbs.twimg.com/media/..."
REPLY_ARTICLE_IMAGE2..N / QUOTED_ARTICLE_IMAGE2..N / RETWEET_ARTICLE_IMAGE2..NAdditional article images of sub-tweet"https://pbs.twimg.com/media/..."
REPLY_ARTICLE_VIDEO2..N / QUOTED_ARTICLE_VIDEO2..N / RETWEET_ARTICLE_VIDEO2..NAdditional article videos of sub-tweet"https://video.twimg.com/..."
POLL_CHOICE1_LABEL / POLL_CHOICE2_LABEL / ... / POLL_CHOICEN_LABELText label for each poll choice (set when the tweet contains a poll)"Yes"
POLL_CHOICE1_VOTES / POLL_CHOICE2_VOTES / ... / POLL_CHOICEN_VOTESRaw vote count for each poll choice"1234"
POLL_CHOICE1_PERCENT / POLL_CHOICE2_PERCENT / ... / POLL_CHOICEN_PERCENTRounded 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_IMAGEImage URL for each poll choice. Only set on image polls; text-only polls expose labels alone."https://pbs.twimg.com/card_img/..."
POLL_TOTAL_VOTESTotal votes across all choices"4521"
POLL_DURATION_MINUTESPoll duration in minutes"1440"
POLL_END_ATPoll end time as epoch milliseconds (falls back to the raw ISO string if parsing fails)"1757946600000"
POLL_IS_ENDEDSet 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_COUNTAuthor's following count"1018"
REPLY_AUTHOR_IDUser ID of replied-to user"14355836"
QUOTED_AUTHOR_IDUser ID of quoted user"19995253"
IS_TWITTER_SEARCHWhether tweet was found via Twitter search"true"
REPLY_TWEET_LINKURL to the parent tweet"https://x.com/user/status/..."
QUOTED_TWEET_LINKURL to the quoted tweet"https://x.com/user/status/..."
RETWEET_TWEET_LINKURL to the retweeted tweet"https://x.com/user/status/..."
REPLY_IMAGE2 / REPLY_IMAGE3 / REPLY_IMAGE4Additional images in replied-to tweet"https://pbs.twimg.com/media/..."
REPLY_VIDEO2 / REPLY_VIDEO3 / REPLY_VIDEO4Additional videos in replied-to tweet"https://video.twimg.com/..."
QUOTED_IMAGE2 / QUOTED_IMAGE3 / QUOTED_IMAGE4Additional images in quoted tweet"https://pbs.twimg.com/media/..."
QUOTED_VIDEO2 / QUOTED_VIDEO3 / QUOTED_VIDEO4Additional videos in quoted tweet"https://video.twimg.com/..."
RETWEET_IMAGE2 / RETWEET_IMAGE3 / RETWEET_IMAGE4Additional images in retweeted tweet"https://pbs.twimg.com/media/..."
RETWEET_VIDEO2 / RETWEET_VIDEO3 / RETWEET_VIDEO4Additional videos in retweeted tweet"https://video.twimg.com/..."
QUOTED_AUTHOR_BIOBio of quoted user"Building the future"
QUOTED_AUTHOR_CREATED_ATAccount creation date of quoted user"2020-01-01T..."
QUOTED_AUTHOR_LOCATIONLocation of quoted user"New York"
QUOTED_AUTHOR_PROFILE_BANNERBanner image of quoted user"https://pbs.twimg.com/profile_banners/..."
QUOTED_AUTHOR_WEBSITEWebsite of quoted user"https://example.com"
QUOTED_AUTHOR_IS_BLUE_VERIFIEDWhether the quoted user has a blue checkmark"true"
QUOTED_AUTHOR_VERIFIED_TYPEQuoted user's verification type"Business" / "Government"
QUOTED_AUTHOR_AFFILIATE_DESCRIPTIONQuoted user's affiliate badge description"BAGS"
QUOTED_AUTHOR_AFFILIATE_BADGE_URLQuoted user's affiliate badge image URL"https://pbs.twimg.com/..."
QUOTED_AUTHOR_AFFILIATE_URLQuoted user's affiliate link URL"https://example.com"
QUOTED_AUTHOR_AFFILIATE_LABEL_TYPEQuoted user's affiliate label type"BusinessLabel"
RETWEET_AUTHOR_BIOBio of retweeted user"Crypto enthusiast"
RETWEET_AUTHOR_CREATED_ATAccount creation date of retweeted user"2019-06-01T..."
RETWEET_AUTHOR_LOCATIONLocation of retweeted user"Miami"
RETWEET_AUTHOR_PROFILE_BANNERBanner image of retweeted user"https://pbs.twimg.com/profile_banners/..."
RETWEET_AUTHOR_WEBSITEWebsite of retweeted user"https://example.com"
RETWEET_AUTHOR_IS_BLUE_VERIFIEDWhether the retweeted user has a blue checkmark"true"
RETWEET_AUTHOR_VERIFIED_TYPERetweeted user's verification type"Business" / "Government"
RETWEET_AUTHOR_AFFILIATE_DESCRIPTIONRetweeted user's affiliate badge description"BAGS"
RETWEET_AUTHOR_AFFILIATE_BADGE_URLRetweeted user's affiliate badge image URL"https://pbs.twimg.com/..."
RETWEET_AUTHOR_AFFILIATE_URLRetweeted user's affiliate link URL"https://example.com"
RETWEET_AUTHOR_AFFILIATE_LABEL_TYPERetweeted user's affiliate label type"BusinessLabel"
REPLY_AUTHOR_BIOBio of replied-to user"DeFi builder"
REPLY_AUTHOR_CREATED_ATAccount creation date of replied-to user"2018-03-15T..."
REPLY_AUTHOR_LOCATIONLocation of replied-to user"London"
REPLY_AUTHOR_PROFILE_BANNERBanner image of replied-to user"https://pbs.twimg.com/profile_banners/..."
REPLY_AUTHOR_WEBSITEWebsite of replied-to user"https://example.com"
REPLY_AUTHOR_IS_BLUE_VERIFIEDWhether the replied-to user has a blue checkmark"true"
REPLY_AUTHOR_VERIFIED_TYPEReplied-to user's verification type"Business" / "Government"
REPLY_AUTHOR_AFFILIATE_DESCRIPTIONReplied-to user's affiliate badge description"BAGS"
REPLY_AUTHOR_AFFILIATE_BADGE_URLReplied-to user's affiliate badge image URL"https://pbs.twimg.com/..."
REPLY_AUTHOR_AFFILIATE_URLReplied-to user's affiliate link URL"https://example.com"
REPLY_AUTHOR_AFFILIATE_LABEL_TYPEReplied-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

TagDescriptionExample
TYPEEvent category"TWEET_VIEWS_MILESTONE"
MILESTONE_THRESHOLDViews multiplier that was crossed"2" / "5" / "10"
VIEW_COUNTCurrent view count at time of milestone"20034"
AUTHOR_IDTwitter user ID"76766018"
AUTHOR_HANDLETwitter username"Dexerto"
AUTHOR_NAMEDisplay name"Dexerto"
AUTHOR_ICONProfile picture URL"https://pbs.twimg.com/..."
AUTHOR_FOLLOWERS_COUNTAuthor's follower count"1322255"
TWEET_IDTweet ID"2041246055941980628"
TWEET_TEXTTweet content"A jar of Nutella floating..."
TWEET_LINKURL to tweet"https://x.com/Dexerto/status/..."
IMAGE / IMAGE2 / IMAGE3 / IMAGE4Attached image URLs"https://pbs.twimg.com/media/..."
VIDEOVideo URL if present"https://video.twimg.com/..."
VIDEO_THUMBNAILVideo thumbnail"https://pbs.twimg.com/..."
LABELAccount label if set"News Outlet"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"FOLLOW"
AUTHOR_IDFollower's user ID"1176026136117166080"
AUTHOR_HANDLEWho followed"rawsalerts"
AUTHOR_NAMETheir display name"R A W S A L E R T S"
AUTHOR_ICONTheir avatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAuthor's account creation date"Mon Sep 23 06:51:06 +0000 2019"
AUTHOR_FOLLOWERS_COUNTAuthor's follower count"1691100"
AUTHOR_FOLLOWING_COUNTAuthor's following count"42"
AUTHOR_BIOAuthor's bio"RawsAlerts is your go-to source for fast, accurate breaking news"
AUTHOR_LOCATIONAuthor's location"United states"
AUTHOR_WEBSITEAuthor's website"https://polymarket.com"
AUTHOR_PROFILE_BANNERAuthor's banner URL"https://pbs.twimg.com/profile_banners/..."
AUTHOR_IS_BLUE_VERIFIEDAuthor's blue verified status"true"
AUTHOR_VERIFIED_TYPEAuthor's verification type"Business"
AUTHOR_AFFILIATE_DESCRIPTIONAuthor's affiliate org description"Polymarket"
AUTHOR_AFFILIATE_BADGE_URLAuthor's affiliate badge image URL"https://pbs.twimg.com/..."
AUTHOR_AFFILIATE_URLAuthor's affiliate link URL"https://twitter.com/Polymarket"
AUTHOR_AFFILIATE_LABEL_TYPEAuthor's affiliate label type"BusinessLabel"
FOLLOWED_HANDLEWho was followed"Real69Minutes"
FOLLOWED_NAMETheir display name"69 Minutes"
FOLLOWED_IDFollowed user's ID"1814788640415096834"
FOLLOWED_ICONTheir avatar URL"https://pbs.twimg.com/..."
FOLLOWED_BIOTheir bio text"Welcome to 69 Minutes hosted by Alex Stone!"
FOLLOWED_BIO_TRANSLATEDTranslated bio if non-English"... [Translated]"
FOLLOWED_BANNERTheir banner image URL"https://pbs.twimg.com/profile_banners/..."
FOLLOWED_FOLLOWERSTheir follower count"7401"
FOLLOWED_FOLLOWING_COUNTTheir following count"371"
FOLLOWED_URLTheir website if set"http://www.69minutes.media"
FOLLOWED_LOCATIONTheir location if set"Only on X"
FOLLOWED_CREATED_ATWhen followed account was created"1721514315000"
FOLLOWED_IS_BLUE_VERIFIEDFollowed user's blue verified status"true"
FOLLOWED_VERIFIED_TYPEFollowed user's verification type"blue"
CONTRACT_ADDRESSCA detected in bio"pump..."
CHAINBlockchain if CA detected"SOL"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"UNFOLLOW"
AUTHOR_IDUnfollower's user ID"44553913"
AUTHOR_HANDLEWho unfollowed"Nate_Esparza"
AUTHOR_NAMETheir display name"Nate Esparza"
AUTHOR_ICONTheir avatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAuthor's account creation date"Thu Jun 04 05:29:03 +0000 2009"
AUTHOR_FOLLOWERS_COUNTAuthor's follower count"55911"
AUTHOR_BIOAuthor's bio"Ads Product @X"
AUTHOR_LOCATIONAuthor's location"CU-Boulder"
AUTHOR_WEBSITEAuthor's website"https://business.x.com/..."
AUTHOR_PROFILE_BANNERAuthor's banner URL"https://pbs.twimg.com/profile_banners/..."
AUTHOR_IS_BLUE_VERIFIEDAuthor's blue verified status"true"
AUTHOR_AFFILIATE_DESCRIPTIONAuthor's affiliate org description"X"
AUTHOR_AFFILIATE_BADGE_URLAuthor's affiliate badge image URL"https://pbs.twimg.com/..."
AUTHOR_AFFILIATE_URLAuthor's affiliate link URL"https://twitter.com/X"
AUTHOR_AFFILIATE_LABEL_TYPEAuthor's affiliate label type"BusinessLabel"
FOLLOWED_IDUnfollowed user's ID"3096147528"
FOLLOWED_HANDLEWho was unfollowed"dom_lucre"
FOLLOWED_NAMETheir display name"Dom Lucre | Breaker of Narratives"
FOLLOWED_ICONTheir avatar URL"https://pbs.twimg.com/..."
FOLLOWED_BIOTheir bio text"White House Featured Journalist..."
FOLLOWED_BIO_TRANSLATEDTranslated bio if non-English"... [Translated]"
FOLLOWED_BANNERTheir banner image URL"https://pbs.twimg.com/profile_banners/..."
FOLLOWED_FOLLOWERSTheir follower count"1694165"
FOLLOWED_FOLLOWING_COUNTTheir following count"3106"
FOLLOWED_LOCATIONTheir location if set"Miami, FL"
FOLLOWED_URLTheir website if set"https://domlucre.org"
FOLLOWED_CREATED_ATWhen unfollowed account was created"1426681046000"
FOLLOWED_IS_BLUE_VERIFIEDUnfollowed user's blue verified status"true"
FOLLOWED_VERIFIED_TYPEUnfollowed user's verification type"blue"
CONTRACT_ADDRESSCA detected in bio"pump..."
CHAINBlockchain if CA detected"SOL"
SOURCE_URLProfile URL"https://x.com/dom_lucre"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"BIO_CHANGE"
AUTHOR_IDUser ID"16573941"
AUTHOR_HANDLEUsername"netflix"
AUTHOR_NAMEDisplay name"Netflix"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1223007377000"
AUTHOR_FOLLOWERS_COUNTFollower count"26073545"
AUTHOR_LOCATIONLocation"California, USA"
AUTHOR_WEBSITEWebsite"https://netflix.com"
AUTHOR_PROFILE_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
AUTHOR_VERIFIED_TYPEVerification type"business"
OLD_BIOPrevious bio text"it's xo kitty week ✨"
NEW_BIONew bio text"FURY VS MAKHMUDOV"
OLD_BIO_TRANSLATEDOld bio translation"... [Translated]"
NEW_BIO_TRANSLATEDNew bio translation"... [Translated]"
CONTRACT_ADDRESSCA detected in new bio"pump..."
CHAINBlockchain if CA detected"SOL"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"NAME_CHANGE"
AUTHOR_IDUser ID"46302096"
AUTHOR_HANDLEUsername"JoeyMannarino"
AUTHOR_NAMEDisplay name (new name)"Joey Mannarino"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1244690436000"
AUTHOR_FOLLOWERS_COUNTFollower count"672187"
AUTHOR_BIOBio"Co-Founder of The Overton Institute..."
AUTHOR_PROFILE_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
OLD_NAMEPrevious display name"Joey Mannarino 🇺🇸"
NEW_NAMENew display name"Joey Mannarino"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"PROFILE_PICTURE_CHANGE"
AUTHOR_IDUser ID"1565089861245313027"
AUTHOR_HANDLEUsername"iruletheworldmo"
AUTHOR_NAMEDisplay name"🍓🍓🍓"
AUTHOR_ICONAvatar URL (new avatar)"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1661981517000"
AUTHOR_FOLLOWERS_COUNTFollower count"101033"
AUTHOR_BIOBio"GPT6 IS ASI"
AUTHOR_LOCATIONLocation"sams basement"
AUTHOR_WEBSITEWebsite"https://mstrawberryman-ui.github.io/..."
AUTHOR_PROFILE_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
AUTHOR_IS_BLUE_VERIFIEDBlue verified status"true"
AUTHOR_VERIFIED_TYPEVerification type"blue"
OLD_PROFILE_PICTUREPrevious avatar URL"https://pbs.twimg.com/..."
NEW_PROFILE_PICTURENew avatar URL"https://pbs.twimg.com/..."
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"BANNER_CHANGE"
AUTHOR_IDUser ID"1598253668175847425"
AUTHOR_HANDLEUsername"onusoz"
AUTHOR_NAMEDisplay name"Onur Solmaz"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1669888391000"
AUTHOR_FOLLOWERS_COUNTFollower count"4419"
AUTHOR_BIOBio"Maintainer @openclaw, Founding Engineer @textcortex..."
AUTHOR_WEBSITEWebsite"https://solmaz.io"
AUTHOR_PROFILE_BANNERBanner URL (new banner)"https://pbs.twimg.com/profile_banners/..."
OLD_BANNERPrevious banner URL (empty string if no previous banner)""
NEW_BANNERNew banner URL"https://pbs.twimg.com/profile_banners/..."
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"TWEET"
SUBTYPEEvent type"DELETED_TWEET"
AUTHOR_IDTwitter user ID"1786465176113561600"
AUTHOR_HANDLEUsername"StrategyMaxi"
AUTHOR_NAMEDisplay name"100% Strategy"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1714761475000"
AUTHOR_FOLLOWERS_COUNTFollower count"10041"
AUTHOR_BIOBio"Strategy Maxi - All In $MSTR"
AUTHOR_LOCATIONLocation"Strategy"
AUTHOR_IS_BLUE_VERIFIEDBlue verified status"true"
AUTHOR_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
TWEET_IDID of deleted tweet"2043389521816097190"
DELETED_URLURL of deleted tweet"https://x.com/StrategyMaxi/status/..."
DELETED_CONTENTRaw original content (includes RT prefix for retweets)"I blame on ideological Bitcoiners..."
TWEET_TEXTTweet content of deleted tweet"I blame on ideological Bitcoiners..."
TWEET_TEXT_TRANSLATEDTranslation if non-English"... [Translated]"
SOURCE_URLURL to the deleted tweet"https://x.com/StrategyMaxi/status/..."
IS_REPLYWas it a reply"true" / "false"
IS_QUOTEWas it a quote"true" / "false"
IS_RETWEETWas it a retweet"true" / "false"
QUOTED_AUTHOR_HANDLEUsername of quoted user"glove"
QUOTED_AUTHOR_NAMEName of quoted user"G. Love"
QUOTED_AUTHOR_ICONAvatar of quoted user"https://pbs.twimg.com/..."
QUOTED_TWEET_IDID of quoted tweet"2043047396322451700"
QUOTED_TWEET_TEXTContent of quoted tweet"I had a really tough day..."
QUOTED_TWEET_TEXT_TRANSLATEDTranslated quoted tweet"... [Translated]"
QUOTED_TWEET_LINKURL to quoted tweet"https://x.com/glove/status/..."
QUOTED_AUTHOR_CREATED_ATQuoted author's account creation date"Tue Feb 03 19:21:52 +0000 2009"
QUOTED_AUTHOR_FOLLOWERS_COUNTQuoted author's follower count"65621"
QUOTED_AUTHOR_BIOQuoted author's bio"My New album..."
QUOTED_AUTHOR_LOCATIONQuoted author's location"Philly, PA!"
QUOTED_AUTHOR_PROFILE_BANNERQuoted author's banner"https://pbs.twimg.com/profile_banners/..."
QUOTED_AUTHOR_WEBSITEQuoted author's website"https://ffm.bio/..."
REPLY_AUTHOR_HANDLEUsername of replied-to user"other_user"
REPLY_AUTHOR_NAMEName of replied-to user"Other User"
REPLY_TWEET_TEXTContent of replied-to tweet"Original reply text..."
REPLY_TWEET_TEXT_TRANSLATEDTranslated reply tweet"... [Translated]"
RETWEET_AUTHOR_HANDLEUsername of retweeted user"magills_"
RETWEET_AUTHOR_NAMEName of retweeted user"Magills"
RETWEET_AUTHOR_ICONAvatar of retweeted user"https://pbs.twimg.com/..."
RETWEET_TWEET_IDID of retweeted tweet"2043346264822010275"
RETWEET_TWEET_TEXTContent of retweeted tweet"Retweeted content..."
RETWEET_TWEET_TEXT_TRANSLATEDTranslated retweet"... [Translated]"
RETWEET_TWEET_LINKURL to retweeted tweet"https://x.com/magills_/status/..."
RETWEET_AUTHOR_CREATED_ATRetweeted author's account creation date"Mon Jan 02 02:26:35 +0000 2017"
RETWEET_AUTHOR_FOLLOWERS_COUNTRetweeted author's follower count"38064"
RETWEET_AUTHOR_BIORetweeted author's bio"I fix broken buildings..."
RETWEET_AUTHOR_LOCATIONRetweeted author's location"The Midwest"
RETWEET_AUTHOR_PROFILE_BANNERRetweeted author's banner"https://pbs.twimg.com/profile_banners/..."
RETWEET_AUTHOR_IS_BLUE_VERIFIEDRetweeted author's blue verified status"true"
IMAGE / IMAGE2 / IMAGE3 / IMAGE4Images from deleted tweet"https://pbs.twimg.com/media/..."
VIDEOVideo from deleted tweet"https://video.twimg.com/..."
VIDEO_THUMBNAILVideo thumbnail"https://pbs.twimg.com/..."
CONTRACT_ADDRESSCA if detected in tweet"Dde2MApjiq...pump"
CHAINBlockchain if CA detected"SOL"
LABELAccount label (user-defined)"Alpha Trader"
CATEGORYAccount 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

TagDescriptionExample
CHAINBlockchain if CA detected"ETHEREUM"
CONTRACT_ADDRESSDetected token CA"0x548fefd928..."
CHANNEL_IDTelegram channel ID"basepairs"
CHANNEL_NAMEChannel display name"Base new Pairs / Contracts"
CHANNEL_ICONChannel avatar URL"https://cdn4.telesco.pe/..."
MESSAGE_IDMessage ID"696e8a6f22a5d24755424516"
MESSAGE_TEXTMessage content"📜 New contract deployed!..."
MESSAGE_TEXT_TRANSLATEDTranslation if non-English"... [Translated]"
MESSAGE_IMAGEAttached image URL"https://..."
MESSAGE_LINKLink to message"https://t.me/BasePairs/2957755"
IS_FORWARDWhether message is forwarded"true"
FORWARDED_CHANNEL_IDOriginal channel handle"monitoringsituation"
FORWARDED_CHANNEL_NAMEOriginal channel name"Monitoring The Situation"
FORWARDED_MESSAGE_IDOriginal message ID"4304"
FORWARDED_MESSAGE_LINKLink 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

TagDescriptionExample
TYPEEvent category"TRUTH_SOCIAL"
SUBTYPEEvent type"POST"
AUTHOR_IDTruth Social user ID"107780257626128497"
AUTHOR_TWITTER_IDLinked Twitter ID"107780257626128497"
AUTHOR_USERNAMEUsername"realDonaldTrump"
AUTHOR_DISPLAY_NAMEDisplay name"Donald J. Trump"
AUTHOR_ICONProfile picture URL"https://..."
POST_IDPost ID"115923723486523883"
POST_TEXTPost content"..."
POST_URLURL to post"https://truthsocial.com/@realDonaldTrump/..."
IMAGEAttached image URL"https://..."
VIDEOAttached video URL"https://..."
SOURCE_URLURL 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

TagDescriptionExample
TYPEEvent category"WARPCAST"
SUBTYPEEvent type"POST"
AUTHOR_IDFarcaster user ID"12345"
AUTHOR_USERNAMEUsername (lowercase)"vitalik.eth"
AUTHOR_DISPLAY_NAMEDisplay name"Vitalik Buterin"
AUTHOR_ICONProfile picture URL"https://..."
CAST_IDCast hash ID"0x..."
CAST_TEXTCast content"..."
POST_URLURL to post"https://warpcast.com/..."
IS_REPLYIs this a reply to another cast"true" / "false"
IMAGE / IMAGE2 / IMAGE3 / IMAGE4Attached image URLs"https://..."
VIDEO / VIDEO2 / VIDEO3 / VIDEO4Attached video URLs"https://..."
CONTRACT_ADDRESSCA if detected"pump..."
CHAINBlockchain 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

TagDescriptionExample
CHAINBlockchain"BASE" / "SOL"
CONTRACT_ADDRESSSwapped token address"0x7df3fd4e53..."
WALLET_ADDRESSWallet address"0x5b0051e4ea..."
WALLET_LABELWallet label if set"b2"
WALLET_URLBlock explorer URL"https://basescan.org/address/..."
TRANSACTION_ACTIONBUY or SELL"BUY"
TRANSACTION_TYPETransaction type"SWAP"
TRANSACTION_PLATFORMDEX/platform used"RAYDIUM" / "PUMP_FUN"
TRANSACTION_IDTransaction hash"0x83196361e82b..."
TRANSACTION_TIMESTAMPUnix timestamp"1768852449"
FROM_TOKEN_TICKERToken sold symbol"WETH"
FROM_TOKEN_AMOUNTAmount sold"0.25"
TO_TOKEN_TICKERToken bought symbol"SMILE"
TO_TOKEN_AMOUNTAmount bought"7497.501388487983"
BASE_TOKEN_TICKERBase currency"WETH"
BASE_TOKEN_AMOUNT_USDUSD value of trade"820.315"
SWAPPED_TOKEN_ADDRESSToken contract address"0x7df3fd4e53..."
SWAPPED_TOKEN_TICKERToken symbol"SMILE"
SWAPPED_TOKEN_NAMEToken name"SMILE"
SWAPPED_TOKEN_AMOUNTAmount swapped"7497.501388487983"
SWAPPED_TOKEN_IMAGE_URLToken image"https://logos.uniwhales.io/..."
SWAPPED_TOKEN_MARKET_CAP_USDMarket cap"5000000"
SWAPPED_TOKEN_SUPPLY_PERCENTAGE% of supply traded"0.5"
SWAPPED_TOKEN_BALANCEPost-trade balance"1000000"
SWAPPED_TOKEN_BALANCE_USDBalance in USD"150.00"
SWAPPED_TOKEN_BALANCE_SUPPLY_PERCENTAGEBalance % of supply"0.1"
FIRST_INTERACTIONFirst time wallet interacted with token"true" / "false"
TRANSACTION_URLBlock explorer URL for transaction"https://solscan.io/tx/..."
PREFERRED_TRADING_URLBest trading URL"https://gmgn.ai/..."
PHOTON_URLPhoton trading URL"https://photon-base.tinyastro.io/..."
FOMO_URLFOMO 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

TagDescriptionExample
CHAINBlockchain"SOL"
CONTRACT_ADDRESSToken address"8vzmc7He4DDxzU..."
WALLET_ADDRESSReceiver wallet"42cfcPtPRHN6YQ..."
WALLET_URLBlock explorer URL"https://solscan.io/address/..."
TRANSACTION_TYPETransaction type"TOKEN_RECEIVED"
TRANSACTION_IDTransaction hash"2JmVD2GGr9Mzkd..."
TRANSACTION_TIMESTAMPUnix timestamp"1768856761"
TOKEN_ADDRESSToken contract"8vzmc7He4DDxzU..."
TOKEN_TICKERToken symbol"SPS"
TOKEN_NAMEToken name"Solid Poops Season"
TOKEN_IMAGE_URLToken image"https://ipfs.io/ipfs/..."
TOKEN_AMOUNTAmount transferred"1.0E7"
TOKEN_AMOUNT_USDUSD value"0.0"
TOKEN_BALANCEBalance after"1.0E7"
TOKEN_BALANCE_USDBalance USD value"0.0"
TOKEN_PRICE_USDToken price"0.0"
TOKEN_SUPPLYTotal supply"1.0E9"
TOKEN_SUPPLY_PERCENTAGE% of supply transferred"1.0"
TOKEN_BALANCE_SUPPLY_PERCENTAGEBalance % of supply"1.0"
TOKEN_MARKET_CAP_USDMarket cap"0.0"
WALLET_LABELLabel for tracked wallet"Alpha Whale"
SENDER_ADDRESSSender wallet"H5jbQTiL2FVxPi..."
SENDER_LABELLabel for sender wallet if set"Dev Wallet"
SENDER_BALANCE_AFTERSender balance after"1.0881978609146E7"
RECEIVER_ADDRESSReceiver wallet"42cfcPtPRHN6YQ..."
RECEIVER_LABELReceiver label if set"BonkFun Dev"
RECEIVER_BALANCE_AFTERReceiver balance after"1.0E7"
COUNTERPARTY_ADDRESSOther party address"H5jbQTiL2FVxPi..."
COUNTERPARTY_URLOther party explorer URL"https://solscan.io/address/..."
PREFERRED_TRADING_URLBest trading URL"https://trade.padre.gg/..."
SOURCE_URLTransaction 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

TagDescriptionExample
CHAINBlockchain"SOL"
CONTRACT_ADDRESSToken address"8vzmc7He4DDxzU..."
WALLET_ADDRESSSender wallet"42cfcPtPRHN6YQ..."
WALLET_LABELLabel for tracked wallet"Alpha Whale"
WALLET_URLBlock explorer URL"https://solscan.io/address/..."
TRANSACTION_TYPETransaction type"TOKEN_SENT"
TRANSACTION_IDTransaction hash"2JmVD2GGr9Mzkd..."
TRANSACTION_TIMESTAMPUnix timestamp"1768856761"
TOKEN_ADDRESSToken contract"8vzmc7He4DDxzU..."
TOKEN_TICKERToken symbol"SPS"
TOKEN_NAMEToken name"Solid Poops Season"
TOKEN_IMAGE_URLToken image"https://ipfs.io/ipfs/..."
TOKEN_AMOUNTAmount transferred"1.0E7"
TOKEN_AMOUNT_USDUSD value"0.0"
TOKEN_PRICE_USDToken price"0.0"
TOKEN_BALANCEBalance after"1.0E7"
TOKEN_BALANCE_USDBalance USD value"0.0"
TOKEN_SUPPLYTotal supply"1.0E9"
TOKEN_SUPPLY_PERCENTAGE% of supply transferred"1.0"
TOKEN_BALANCE_SUPPLY_PERCENTAGEBalance % of supply"1.0"
TOKEN_MARKET_CAP_USDMarket cap"0.0"
SENDER_ADDRESSSender wallet"42cfcPtPRHN6YQ..."
SENDER_LABELLabel for sender wallet if set"Dev Wallet"
SENDER_BALANCE_AFTERSender balance after"0"
SENDER_BALANCE_AFTER_USDSender balance USD"0.0"
SENDER_BALANCE_SUPPLY_PERCENTAGESender balance % of supply"0.0"
RECEIVER_ADDRESSReceiver wallet"H5jbQTiL2FVxPi..."
RECEIVER_LABELReceiver label if set"BonkFun Dev"
RECEIVER_BALANCE_AFTERReceiver balance after"1.0E7"
RECEIVER_BALANCE_AFTER_USDReceiver balance USD"0.0"
RECEIVER_BALANCE_SUPPLY_PERCENTAGEReceiver balance % of supply"1.0"
COUNTERPARTY_ADDRESSOther party address"H5jbQTiL2FVxPi..."
COUNTERPARTY_URLOther party explorer URL"https://solscan.io/address/..."
PREFERRED_TRADING_URLBest trading URL"https://trade.padre.gg/..."
SOURCE_URLTransaction 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

TagDescriptionExample
CHAINAlways SOL"SOL"
TRANSACTION_TYPETransaction type"SOL_RECEIVED"
TRANSACTION_IDTransaction hash"abc..."
TRANSACTION_TIMESTAMPUnix timestamp"1768856761"
WALLET_ADDRESSReceiver wallet"abc..."
WALLET_LABELLabel for tracked wallet"Alpha Whale"
WALLET_URLBlock explorer URL"https://solscan.io/address/..."
SOL_AMOUNTAmount in SOL"1.5"
WALLET_BALANCE_AFTERBalance after transfer"10.5"
SENDER_ADDRESSSender wallet"xyz..."
SENDER_LABELLabel for sender wallet"Dev Wallet"
SENDER_BALANCE_AFTERSender balance after"10.5"
RECEIVER_ADDRESSReceiver wallet"abc..."
RECEIVER_LABELLabel for receiver wallet"CEX Deposit"
RECEIVER_BALANCE_AFTERReceiver balance after"5.0"
COUNTERPARTY_ADDRESSOther party address"xyz..."
COUNTERPARTY_URLOther party explorer URL"https://solscan.io/address/..."
SOURCE_URLTransaction 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

TagDescriptionExample
CHAINAlways SOL"SOL"
TRANSACTION_TYPETransaction type"SOL_SENT"
TRANSACTION_IDTransaction hash"abc..."
TRANSACTION_TIMESTAMPUnix timestamp"1768856761"
WALLET_ADDRESSSender wallet"abc..."
WALLET_LABELLabel for tracked wallet"Alpha Whale"
WALLET_URLBlock explorer URL"https://solscan.io/address/..."
SOL_AMOUNTAmount in SOL"1.5"
WALLET_BALANCE_AFTERBalance after transfer"10.5"
SENDER_ADDRESSSender wallet"abc..."
SENDER_LABELLabel for sender wallet"Dev Wallet"
SENDER_BALANCE_AFTERSender balance after"10.5"
RECEIVER_ADDRESSReceiver wallet"xyz..."
RECEIVER_LABELLabel for receiver wallet"CEX Deposit"
RECEIVER_BALANCE_AFTERReceiver balance after"5.0"
COUNTERPARTY_ADDRESSOther party address"xyz..."
COUNTERPARTY_URLOther party explorer URL"https://solscan.io/address/..."
SOURCE_URLTransaction 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

TagDescriptionExample
CHAINBlockchain/platform"HYPERLIQUID"
WALLET_ADDRESSTrader wallet"0x8f8b4759dc93..."
WALLET_LABELWallet label if set"Mister Todd"
TRANSACTION_ACTIONBUY or SELL"BUY"
TRANSACTION_PLATFORMExchange platform"HYPERLIQUID"
TRANSACTION_IDTransaction hash"0x5903d6548ff2..."
TRANSACTION_TIMESTAMPUnix timestamp"1768852121"
TOKEN_TICKERAsset being traded"SOL"
TOKEN_AMOUNTPosition size change"15.030000000000001"
TOKEN_AMOUNT_USDUSD value of change"2020.6332000000002"
AVERAGE_PRICEEntry/exit price"134.44"
POSITION_ACTIONOPEN/CLOSE/ADD/REDUCE"OPEN"
POSITION_TYPELONG or SHORT"LONG"
POSITION_CHANGE_PERCENT% change in position"Infinity" (new position)
OLD_POSITION_SIZESize before"0.0"
OLD_POSITION_SIZE_USDUSD value before"0.0"
NEW_POSITION_SIZESize after"15.030000000000001"
NEW_POSITION_SIZE_USDUSD value after"2020.6332000000002"
IS_LIQUIDATIONWas 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

TagDescriptionExample
CHAINBlockchain"SOL"
CONTRACT_ADDRESSToken address"Trove4jcQhE1dZ..."
WALLET_COUNTNumber of wallets that bought"10"
THRESHOLDMinimum wallet threshold"10"
MINUTESTime window in minutes"2"
TOTAL_BUY_AMOUNT_USDTotal USD value bought"38323.34473281339"
TOKEN_TICKERToken symbol"TROVE"
TOKEN_NAMEToken name"TROVE"
TOKEN_MARKET_CAP_USDCurrent market cap"8876599.037534805"
TOKEN_IMAGE_URLToken image URL"https://gateway.irys.xyz/..."
TOKEN_TWITTERToken's Twitter handle"@newtoken"
TOKEN_TELEGRAMToken's Telegram link"https://t.me/newtoken"
TOKEN_WEBSITEToken's website URL"https://newtoken.xyz"
BULLX_URLBullX trading URL"https://bullx.io/terminal?..."
AXIOM_URLAxiom trading URL"https://axiom.trade/t/..."
PHOTON_URLPhoton trading URL"https://photon-sol.tinyastro.io/..."
FOMO_URLFOMO trading URL"https://fomo.family/tokens/solana/..."
SOURCE_URLToken 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

TagDescriptionExample
TYPEEvent category"NEWS_ARTICLE"
MATCHED_KEYWORDKeyword that triggered match"bitcoin"
SUMMARYAI-generated summary"Bitcoin reaches new ATH..."
NAMESComma-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

TagDescriptionExample
TYPEEvent category"BINANCE_SQUARE_POST"
ARTICLE_IDPost identifier"123456789"
USERNAMEPoster username"cz_binance"
DISPLAY_NAMEDisplay name"CZ"
TITLEPost title (optional)"Market Update"
CONTENTPost content"The market is looking strong..."
IMAGE_URLCover image URL (optional)"https://..."
AVATARPoster 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

TagDescriptionExample
TYPEEvent category"BINANCE_ALPHA_LISTING"
CONTRACT_ADDRESSToken contract address"0x..."
CHAINBlockchain"BASE" / "SOL" / "BNB"
NAMEToken name"Pepe Token"
SYMBOLToken symbol"PEPE"
MARKET_CAP_USDMarket cap in USD"5000000"
ICONToken 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

TagDescriptionExample
TYPEEvent category"MOONSHOT_LISTING"
TOKEN_TICKERToken symbol"MOON"
CONTRACT_ADDRESSToken contract address"abc123..."
TOKEN_NAMEToken name"Moonshot Token"
CHAINBlockchain"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

TagDescriptionExample
CHAINBlockchain"SOL"
WALLET_ADDRESSDeployer wallet address"abc123..."
WALLET_LABELWallet label if set"Dev Wallet"
TOKEN_ADDRESSToken contract address"pump..."
CONTRACT_ADDRESSToken contract address"pump..."
TOKEN_TICKERToken symbol"NEWTOKEN"
TOKEN_NAMEToken name"New Token"
TOKEN_SUPPLYTotal supply"1000000000"
TOKEN_IMAGE_URLToken image URL"https://..."
TOKEN_DESCRIPTIONToken description (optional)"A revolutionary new token..."
TOKEN_TWITTERTwitter handle (optional)"@newtoken"
TOKEN_TELEGRAMTelegram link (optional)"https://t.me/newtoken"
TOKEN_WEBSITEWebsite URL (optional)"https://newtoken.xyz"
SOL_AMOUNTSOL used in deployment"0.5"
SOL_VALUE_USDUSD value of SOL spent"75.00"
SUPPLY_PERCENTAGEPercentage of supply bought during deploy"1.5"
TRANSACTION_TYPETransaction type"DEPLOY"
TRANSACTION_PLATFORMPlatform used"PUMP_FUN"
TRANSACTION_TIMESTAMPUnix 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

TagDescriptionExample
TYPEEvent category"PUMPFUN_LIVESTREAM"
CONTRACT_ADDRESSToken contract address"pump..."
CHAINBlockchain"SOL"
PUMPFUN_URLPump.fun URL"https://pump.fun/coin/..."
SYMBOLToken symbol"LIVE"
NAMEToken name"Livestream Token"
USD_MARKET_CAPMarket cap in USD"500000"
IMAGEThumbnail image URL (optional)"https://..."
TOKEN_IMAGEToken image URL (optional)"https://..."
PAIR_ADDRESSPair address (optional)"abc..."
DESCRIPTIONToken description (optional)"..."
WEBSITEWebsite URL (optional)"https://..."
TWITTERTwitter handle (optional)"@token"
TELEGRAMTelegram 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

TagDescriptionExample
TYPEEvent category"PUMPFUN_HIGHLIGHT"
CONTRACT_ADDRESSToken contract (mint)"pump..."
CHAINBlockchain"SOL"
PUMPFUN_URLPump.fun coin URL"https://pump.fun/coin/..."
SYMBOLToken symbol"TREND"
NAMEToken name"Trending Token"
USD_MARKET_CAPMarket cap in USD"1000000"
HIGHLIGHT_TITLEHighlight description (optional)"Top Gainer"
IMAGEToken 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

TagDescriptionExample
TYPEEvent category"PUMPFUN_CALLOUT"
CONTRACT_ADDRESSToken contract (mint)"pump..."
CHAINBlockchain"SOL"
MARKET_CAP_USDCurrent market cap"500000"
PUMPFUN_URLPump.fun coin URL"https://pump.fun/coin/..."
CALLOUT_USERUser making the callout"user123"
CALLOUT_PRICEPrice at time of callout"0.0001"
CALLOUT_MULTIPLEMultiple since callout"5.2"
CALLOUT_MAX_PRICE_SOLMax price reached in SOL"0.0005"
SYMBOLToken symbol (optional)"CALL"
NAMEToken name (optional)"Called Token"
IMAGEToken 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

TagDescriptionExample
TYPEEvent category"PUMPFUN_ARTICLE_PUBLISHED"
DOCUMENT_IDArticle document ID"abc123..."
CONTRACT_ADDRESSToken contract (optional)"pump..."
CHAINBlockchain (optional)"SOL"
PUMPFUN_URLPump.fun URL (optional)"https://pump.fun/..."
HEADLINEArticle headline (optional)"New Token Analysis"
PREVIEWArticle preview text (optional)"In this article we explore..."
SYMBOLToken symbol (optional)"ART"
NAMEToken name (optional)"Article Token"
IMAGEToken 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

TagDescriptionExample
TYPEEvent category"BAGS_FEE_CLAIM"
CONTRACT_ADDRESSToken contract address"pump..."
TOKEN_SYMBOLToken symbol"BAGS"
CLAIMER_WALLETClaimer wallet address"abc123..."
CLAIMER_TWITTERClaimer Twitter handle"@claimer"
CLAIMER_ROLERole (creator or royalty recipient)"creator"
ROYALTY_PERCENTAGERoyalty percentage (0-100)"5"
SOL_AMOUNTSOL amount claimed"1.5"
TRANSACTION_IDTransaction signature"abc..."
CHAINBlockchain"SOL"
IS_FIRST_CLAIMWhether 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

TagDescriptionExample
TYPEEvent category"NEW_SUBDOMAIN"
SUBDOMAINFull subdomain name"api.example.com"
DOMAINBase 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

TagDescriptionExample
TYPEEvent category"URL_CHANGE"
PREVIOUS_STATUSPrevious HTTP status code"200"
CURRENT_STATUSCurrent HTTP status code"301"
REMOVEDRemoved content (pipe-separated)"old text|more old"
ADDEDAdded content (pipe-separated)"new text|more new"
CHANGE_PERCENTAGEPercentage of content changed"15.5"
CONTRACT_ADDRESSCA found in added content (optional)"pump..."
CHAINBlockchain 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"WEBSITE_CHANGE"
AUTHOR_IDUser ID"210297577"
AUTHOR_HANDLEUsername"tekkaadan"
AUTHOR_NAMEDisplay name"tekkaadan"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1288493134000"
AUTHOR_FOLLOWERS_COUNTFollower count"3422"
AUTHOR_BIOBio"AI App: https://t.co/..."
AUTHOR_LOCATIONLocation"Dark Continent"
AUTHOR_PROFILE_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
OLD_WEBSITEPrevious website URL"http://litcoin.tech"
NEW_WEBSITENew website URL"http://litcoin.app"
CONTRACT_ADDRESSCA extracted from new website (optional)"pump..."
CHAINBlockchain if CA found (optional)"SOL"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"LOCATION_CHANGE"
AUTHOR_IDUser ID"1469380022213488646"
AUTHOR_HANDLEUsername"guneysol"
AUTHOR_NAMEDisplay name"Guney"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1639162483000"
AUTHOR_FOLLOWERS_COUNTFollower count"3469"
AUTHOR_BIOBio"building @helius / prev. winner @colosseum, @uwaterloo"
AUTHOR_PROFILE_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
OLD_LOCATIONPrevious location (empty string if none)""
NEW_LOCATIONNew location"ca t"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEAffiliate added or removed"AFFILIATE_ADDED" / "AFFILIATE_REMOVED"
AUTHOR_IDUser ID"45959829"
AUTHOR_HANDLEUsername"timeyoutakeit"
AUTHOR_NAMEDisplay name"Amy"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
AUTHOR_CREATED_ATAccount creation date"1244585521000"
AUTHOR_FOLLOWERS_COUNTFollower count"2580"
AUTHOR_FOLLOWING_COUNTFollowing count"1018"
AUTHOR_BIOBio"Everything docs. product @GoogleDeepmind"
AUTHOR_LOCATIONLocation" 🇮🇪 "
AUTHOR_WEBSITEWebsite"https://..."
AUTHOR_BANNERBanner URL"https://pbs.twimg.com/profile_banners/..."
AUTHOR_IS_BLUE_VERIFIEDBlue verified status"true"
AUTHOR_AFFILIATE_DESCRIPTIONAffiliate org name on author profile"Google AI Studio"
ORG_HANDLEOrganization handle"GoogleAIStudio"
ORG_NAMEOrganization display name"Google AI Studio"
ORG_IDOrganization user ID"1742923424056713217"
ORG_ICONOrganization avatar URL"https://pbs.twimg.com/..."
ORG_BIOOrganization bio"The fastest path from prompt to prototype..."
ORG_BANNEROrganization banner URL"https://pbs.twimg.com/profile_banners/..."
ORG_LOCATIONOrganization location"It's time to build"
ORG_WEBSITEOrganization website"https://ai.studio/build"
ORG_FOLLOWERS_COUNTOrganization follower count"153626"
ORG_FOLLOWING_COUNTOrganization following count"2"
ORG_VERIFIED_TYPEOrganization verification type"business"
ORG_CREATED_ATOrganization account creation date"1704380306000"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"PROFILE"
SUBTYPEEvent type"PINNED_CHANGE"
AUTHOR_IDUser ID"779657810405654528"
AUTHOR_HANDLEUsername"TehranTimes79"
AUTHOR_NAMEDisplay name"Tehran Times"
AUTHOR_ICONAvatar URL"https://pbs.twimg.com/..."
OLD_TWEET_IDID of previously pinned tweet (if any)"2042666182533169341"
OLD_TWEET_LINKLink to previously pinned tweet"https://x.com/TehranTimes79/status/..."
OLD_TWEET_TEXTContent of previously pinned tweet"Tomorrow's edition of the Tehran Times..."
OLD_TWEET_TEXT_TRANSLATEDTranslated old tweet"Translated old content..."
OLD_IMAGEImage from old pinned tweet"https://pbs.twimg.com/media/..."
OLD_VIDEOVideo from old pinned tweet"https://video.twimg.com/..."
OLD_VIDEO_THUMBNAILThumbnail for old video"https://pbs.twimg.com/..."
OLD_IMAGE2 / OLD_IMAGE3 / OLD_IMAGE4Additional images from old pinned tweet"https://pbs.twimg.com/media/..."
OLD_CONTRACT_ADDRESSCA in old pinned tweet"oldCA123pump"
OLD_CHAINChain for old CA"SOL"
NEW_TWEET_IDID of newly pinned tweet (if any)"2043033840940105785"
NEW_TWEET_LINKLink to newly pinned tweet"https://x.com/TehranTimes79/status/..."
NEW_TWEET_TEXTContent of newly pinned tweet"Tomorrow's edition of the Tehran Times..."
NEW_TWEET_TEXT_TRANSLATEDTranslated new tweet (if applicable)"Translated content..."
NEW_IMAGEImage from new pinned tweet"https://pbs.twimg.com/media/..."
NEW_IMAGE2 / NEW_IMAGE3 / NEW_IMAGE4Additional images from new pinned tweet"https://pbs.twimg.com/media/..."
NEW_VIDEOVideo from new pinned tweet"https://video.twimg.com/..."
NEW_VIDEO_THUMBNAILThumbnail for new video"https://pbs.twimg.com/..."
NEW_CONTRACT_ADDRESSCA in new pinned tweet"abc123pump"
NEW_CHAINChain for new CA"SOL"
CONTRACT_ADDRESSDetected contract address"abc123pump"
CHAINBlockchain of contract"SOL"
LABELAccount label (user-defined)"DeFi Protocol"
CATEGORYAccount 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

TagDescriptionExample
TYPEEvent category"MOLTBOOK_AGENT_CREATION"
AGENT_NAMEName of the AI agent"TradingBot"
AGENT_URLURL to the agent"https://moltbook.com/agent/..."
AUTHOR_HANDLECreator's Twitter handle"@creator"
AUTHOR_NAMECreator's display name"Agent Creator"
AUTHOR_URLCreator's profile URL"https://x.com/creator"
AUTHOR_BIOCreator's bio"Building AI agents"
AUTHOR_LOCATIONCreator's location"San Francisco"
AUTHOR_PROFILE_IMAGECreator's avatar"https://pbs.twimg.com/..."
AUTHOR_BANNERCreator's banner image"https://pbs.twimg.com/..."
FOLLOWER_COUNTCreator's follower count"50000"
TWEET_IDAssociated tweet ID"1234567890"
TWEET_TEXTTweet content"Launching my new agent..."
AUTHOR_TWITTER_IDCreator's Twitter user ID"123456789"
TWEET_URLLink 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

TagDescriptionExample
TYPEEvent category"NEW_YOUTUBE_VIDEO"
CHANNEL_IDYouTube channel ID"UCxxxxxxxxxx"
VIDEO_TITLETitle of the video"Market Analysis 2024"
VIDEO_SUMMARYAI-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

TagDescriptionExample
TYPEEvent category"NEW_YOUTUBE_VIDEO_TRANSCRIPT"
CHANNEL_IDYouTube channel ID"UCxxxxxxxxxx"
VIDEO_TITLETitle of the video"Market Analysis 2024"
VIDEO_SUMMARYSummary 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
}
REST API
Manage your Twitter tracking settings programmatically.

Base URL

https://news.bark.gg

Authentication

All requests require your API key in the X-API-KEY header:

X-API-KEY: <your api key>
GET
/settings/twitter/categories/{category}
Get all Twitter accounts in a category.

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
    }
  }
}
PUT
/settings/twitter/categories/{category}/{handle}
Add or update a Twitter account in a category. For system categories (AD_HOC, IMPORTANT, INFLUENCERS, NEWS, ZOOS, COIN_TEAMS, HYPERLIQUID), you can only update monitoring settings of accounts that already exist in your category. To add or remove accounts, use the CUSTOM category. For the CUSTOM category, you can freely add new accounts.

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 ID

Query Parameters (all optional)

label - Custom label for the account
contractAddress - Associated token contract address
monitorTweets - 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.

DELETE
/settings/twitter/categories/{category}/{handle}
Remove a Twitter account from the CUSTOM category. Accounts cannot be removed from system categories (AD_HOC, IMPORTANT, INFLUENCERS, NEWS, ZOOS, COIN_TEAMS, HYPERLIQUID) as they are managed automatically.

Path Parameters

category - Must be CUSTOM. System categories do not allow account removal.
handle - Twitter handle (without @) or Twitter user ID

Example 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.

POST
/settings/twitter/reset
Reset your Twitter settings to defaults. This re-syncs all system categories (AD_HOC, IMPORTANT, INFLUENCERS, NEWS, ZOOS, COIN_TEAMS, HYPERLIQUID) from the main feed while preserving your CUSTOM category accounts.

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.

Farcaster (Warpcast)
Manage your Farcaster/Warpcast tracking settings.
GET
/settings/warpcast/accounts
Get all tracked Farcaster accounts.

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"
    }
  }
}
PUT
/settings/warpcast/accounts/{username}
Add a Farcaster account to track.

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.

DELETE
/settings/warpcast/accounts/{username}
Remove a Farcaster account from tracking.

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.

Telegram (Group)
BASIC
PRO
ULTRA
Set up Bark for your Telegram group chat.
1

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.

2

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

3

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