Docs
Set up your feed on any platform, master the bot commands, and explore everything the website can do
Terminals
Developers
Open the Feed
Navigate to the News page to view your feed
Customize Your Feed
Configure what you want to track on the Settings page
Find the Bark Bot
Open @BarkFeedBot in Telegram
Connect Your Account
Use the following command to connect the bot to your Bark account:
/login <your api key>You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Configure Settings
Use /twitter track/untrack, /wallet track/untrack, etc. to configure what to track.
You can also configure settings on the Settings page
Important
Run /setup Command
In your Discord server, run the /setup command to:
- Activate your subscription
- Configure who can manage the feed settings
Configure Settings
Use /twitter track/untrack, /wallet track/untrack, etc. to configure what to track.
You can also configure settings on the Settings page
Configure WebSocket Connection
In Tree Terminal, go to Settings → News and set the following fields:
wss://news.bark.gg/wslogin <your api key>You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Add Your API Key
In PvP Terminal, go to Settings → News API and fill in your API key for "Bark News"
You can find your API key on the Account page
Enable the News Feed
Go to Scrapers → Bark News and enable:
- Feed
- Notifications
- Audio
Customize Your Feed
Configure what you want to track on the Settings page
Add Your API Key
In Tuleep Terminal, go to Settings → News trading and add your API key in the section
You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Add Your API Key
In Tealstreet Terminal, go to Settings → News Trading → Bark.gg API key and fill in your API key
You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Connect to WebSocket
Establish a WebSocket connection to the following URL:
wss://news.bark.gg/wsAuthenticate
After connecting, send the following message to authenticate:
login <your api key>You can find your API key on the Account page
Customize Your Feed
Configure what you want to track on the Settings page
Message Structure Overview
The main message format is designed to be compatible with trading terminals (Tree, PvP, etc.). However, all detailed, structured data is available in the tags object. This is where you should look for programmatic access to specific fields.
Base message fields:
_id- Unique identifiersource- Source systemtitle- Human-readable titlebody- Human-readable bodyurl- Primary URLicon- Icon URLimage- Image URLtime- Unix timestamp (ms)tags- Structured datainfo- Additional metadatashow_feed- Show in feedshow_notif- Show notification
Identifying Message Types
All messages include a tags.TYPE field that identifies the message type. This matches the NewsType (e.g., "TWEET", "WALLET_SWAP", "NEW_TELEGRAM_MESSAGE"). Some message types also include a tags.SUBTYPE for more specific categorization.
Common Enrichment Tags
The server automatically enriches all message types with the following tags when applicable. These are not listed per message type below to avoid repetition.
Always added (when available):
SOURCE_URL— URL to the source (from the news URL)
When CONTRACT_ADDRESS is present:
CONTRACT_ADDRESS_LABEL— How the CA was detected (e.g. "CA mentioned", "CA in bio")CONTRACT_ADDRESS_2,CONTRACT_ADDRESS_3, etc. — Additional CAs when multiple are foundPREFERRED_TRADING_URL— User's preferred trading platform URL (suffixed_2,_3for multi-CA)- SOL chain:
BULLX_URL,BULLX_NEO_URL,BULLX_LEGACY_URL,AXIOM_URL,PADRE_URL - All chains (except Hypurr/Hpump):
PHOTON_URL,MAESTRO_URL,BANANA_URL - ETH/BASE chains:
PADRE_URL - BASE chain:
SIGMA_URL,BASED_URL
When WALLET_ADDRESS is present:
WALLET_URL— Block explorer URL for the wallet
When COUNTERPARTY_ADDRESS is present:
COUNTERPARTY_URL— Block explorer URL for the counterparty
New tweets from tracked accounts, including replies, quotes, and retweets. Contains author info, tweet content, media attachments, and detected contract addresses.
How to identify: tags.TYPE === "TWEET" && tags.SUBTYPE === "NEW_TWEET"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TWEET" |
| SUBTYPE | Event type | "NEW_TWEET" |
| AUTHOR_ID | Twitter user ID | "24809221" |
| AUTHOR_HANDLE | Twitter username | "kaiynne" |
| AUTHOR_NAME | Display name | "kain.crates" |
| AUTHOR_ICON | Profile picture URL | "https://pbs.twimg.com/..." |
| TWEET_ID | Tweet ID | "2013337305461989526" |
| TWEET_TEXT | Tweet content (null for RTs) | "We did this airdrop..." |
| TWEET_TEXT_TRANSLATED | Translation if non-English | "... [Translated]" |
| TWEET_LINK | URL to tweet | "https://x.com/kaiynne/status/..." |
| SOURCE_URL | URL to the source (same as TWEET_LINK) | "https://x.com/..." |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Attached image URLs (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| VIDEO / VIDEO2 / VIDEO3 / VIDEO4 | Video URLs if present | "https://video.twimg.com/..." |
| VIDEO_THUMBNAIL / VIDEO_THUMBNAIL2 / VIDEO_THUMBNAIL3 | Thumbnails for videos | "https://pbs.twimg.com/..." |
| LINK_PREVIEW_TITLE | Title from URL embed (OpenGraph) | "Stock market today: Dow soars 1,000 points" |
| LINK_PREVIEW_DESCRIPTION | Description from URL embed (OpenGraph) | "Stocks turned sharply higher on Tuesday..." |
| LINK_PREVIEW_IMAGE | Image from URL embed (OpenGraph) | "https://s.yimg.com/ny/api/res/..." |
| IS_REPLY | Is this a reply | "true" / "false" |
| IS_QUOTE | Is this a quote tweet | "true" / "false" |
| IS_RETWEET | Is this a retweet | "true" / "false" |
| IS_SELF_REPLY | Replying to own tweet | "true" / "false" |
| REPLY_AUTHOR_HANDLE | Username of replied-to user | "katexbt" |
| REPLY_AUTHOR_NAME | Name of replied-to user | "katexbt.hl" |
| REPLY_AUTHOR_ICON | Avatar of replied-to user | "https://pbs.twimg.com/..." |
| REPLY_TWEET_ID | ID of replied-to tweet | "2013104553449660797" |
| REPLY_TWEET_TEXT | Content of replied-to tweet | "If Infinex doesn't..." |
| REPLY_TWEET_TEXT_TRANSLATED | Translation of replied-to tweet if non-English | "... [Translated]" |
| REPLY_IMAGE | Image in replied-to tweet (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| REPLY_VIDEO | Video in replied-to tweet | "https://video.twimg.com/..." |
| REPLY_VIDEO_THUMBNAIL | Thumbnail for reply video | "https://pbs.twimg.com/..." |
| REPLY_LINK_PREVIEW_TITLE | Title from URL embed in replied-to tweet | "Article headline..." |
| REPLY_LINK_PREVIEW_DESCRIPTION | Description from URL embed in replied-to tweet | "Article summary..." |
| REPLY_LINK_PREVIEW_IMAGE | Image from URL embed in replied-to tweet | "https://..." |
| QUOTED_AUTHOR_HANDLE | Username of quoted user | "infinex" |
| QUOTED_AUTHOR_NAME | Name of quoted user | "Infinex" |
| QUOTED_AUTHOR_ICON | Avatar of quoted user | "https://pbs.twimg.com/..." |
| QUOTED_TWEET_ID | ID of quoted tweet | "2013070582989111541" |
| QUOTED_TWEET_TEXT | Content of quoted tweet | "INX Token Generation..." |
| QUOTED_TWEET_TEXT_TRANSLATED | Translation of quoted tweet if non-English | "... [Translated]" |
| QUOTED_IMAGE | Image in quoted tweet (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| QUOTED_VIDEO | Video in quoted tweet | "https://video.twimg.com/..." |
| QUOTED_VIDEO_THUMBNAIL | Thumbnail for quoted video | "https://pbs.twimg.com/..." |
| QUOTED_LINK_PREVIEW_TITLE | Title from URL embed in quoted tweet | "Article headline..." |
| QUOTED_LINK_PREVIEW_DESCRIPTION | Description from URL embed in quoted tweet | "Article summary..." |
| QUOTED_LINK_PREVIEW_IMAGE | Image from URL embed in quoted tweet | "https://..." |
| RETWEET_AUTHOR_HANDLE | Username of retweeted user | "elonmusk" |
| RETWEET_AUTHOR_NAME | Name of retweeted user | "Elon Musk" |
| RETWEET_AUTHOR_ICON | Avatar of retweeted user | "https://pbs.twimg.com/..." |
| RETWEET_AUTHOR_ID | User ID of retweeted user | "44196397" |
| RETWEET_TWEET_ID | ID of retweeted tweet | "2013070582989111541" |
| RETWEET_TWEET_TEXT | Content of retweeted tweet | "Original tweet content..." |
| RETWEET_TWEET_TEXT_TRANSLATED | Translation of retweeted tweet if non-English | "... [Translated]" |
| RETWEET_IMAGE | Image in retweeted tweet (includes link preview images when no media is attached) | "https://pbs.twimg.com/media/..." |
| RETWEET_VIDEO | Video in retweeted tweet | "https://video.twimg.com/..." |
| RETWEET_VIDEO_THUMBNAIL | Thumbnail for retweet video | "https://pbs.twimg.com/..." |
| RETWEET_LINK_PREVIEW_TITLE | Title from URL embed in retweeted tweet | "Article headline..." |
| RETWEET_LINK_PREVIEW_DESCRIPTION | Description from URL embed in retweeted tweet | "Article summary..." |
| RETWEET_LINK_PREVIEW_IMAGE | Image from URL embed in retweeted tweet | "https://..." |
| AUTHOR_FOLLOWERS_COUNT | Tweet author's follower count | "128274" |
| QUOTED_AUTHOR_FOLLOWERS_COUNT | Quoted tweet author's follower count | "500000" |
| RETWEET_AUTHOR_FOLLOWERS_COUNT | Retweeted author's follower count | "1000000" |
| REPLY_AUTHOR_FOLLOWERS_COUNT | Parent tweet author's follower count | "250000" |
| CONTRACT_ADDRESS | Detected token contract address | "8HxW9Z3YT1gXgQ...pump" |
| CHAIN | Blockchain if CA detected | "SOL" / "ETHEREUM" |
| PREFERRED_TRADING_URL | Best trading URL | "https://photon-sol.tinyastro.io/..." |
| LABEL | Account label if set | "Infinex CEO, $MEC" |
| CATEGORY | Account category | "AD_HOC" / "CUSTOM" |
| AUTHOR_BIO | Author's Twitter bio | "Building cool stuff" |
| AUTHOR_CREATED_AT | Author's account creation date | "2012-03-15T..." |
| AUTHOR_LOCATION | Author's location | "San Francisco" |
| AUTHOR_PROFILE_BANNER | Author's banner image URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_WEBSITE | Author's website | "https://example.com" |
| AUTHOR_IS_BLUE_VERIFIED | Whether the author has a blue checkmark | "true" |
| AUTHOR_VERIFIED_TYPE | Author's verification type | "Business" / "Government" |
| AUTHOR_AFFILIATE_DESCRIPTION | Author's affiliate badge description | "BAGS" |
| AUTHOR_AFFILIATE_BADGE_URL | Author's affiliate badge image URL | "https://pbs.twimg.com/..." |
| AUTHOR_AFFILIATE_URL | Author's affiliate link URL | "https://example.com" |
| AUTHOR_AFFILIATE_LABEL_TYPE | Author's affiliate label type | "BusinessLabel" |
| IS_ARTICLE | Whether the tweet is a Twitter article (long-form content) | "true" |
| REPLY_IS_ARTICLE / QUOTED_IS_ARTICLE / RETWEET_IS_ARTICLE | Whether the sub-tweet is a Twitter article | "true" |
| ARTICLE_TITLE | Article title (only when IS_ARTICLE is true) | "My Article Title" |
| ARTICLE_TEXT | Article body text (only when IS_ARTICLE is true) | "Full article content..." |
| ARTICLE_BANNER | Article cover/banner image URL (only when IS_ARTICLE is true) | "https://pbs.twimg.com/media/..." |
| ARTICLE_IMAGE2 / ARTICLE_IMAGE3 / ... / ARTICLE_IMAGEN | Additional article images beyond the banner (only when IS_ARTICLE is true) | "https://pbs.twimg.com/media/..." |
| ARTICLE_VIDEO2 / ARTICLE_VIDEO3 / ... / ARTICLE_VIDEON | Additional article videos beyond the banner (only when IS_ARTICLE is true) | "https://video.twimg.com/..." |
| REPLY_ARTICLE_TITLE / QUOTED_ARTICLE_TITLE / RETWEET_ARTICLE_TITLE | Article title of sub-tweet (only when sub-tweet IS_ARTICLE is true) | "Article Title" |
| REPLY_ARTICLE_TEXT / QUOTED_ARTICLE_TEXT / RETWEET_ARTICLE_TEXT | Article body text of sub-tweet | "Full article content..." |
| REPLY_ARTICLE_BANNER / QUOTED_ARTICLE_BANNER / RETWEET_ARTICLE_BANNER | Article banner image of sub-tweet | "https://pbs.twimg.com/media/..." |
| REPLY_ARTICLE_IMAGE2..N / QUOTED_ARTICLE_IMAGE2..N / RETWEET_ARTICLE_IMAGE2..N | Additional article images of sub-tweet | "https://pbs.twimg.com/media/..." |
| REPLY_ARTICLE_VIDEO2..N / QUOTED_ARTICLE_VIDEO2..N / RETWEET_ARTICLE_VIDEO2..N | Additional article videos of sub-tweet | "https://video.twimg.com/..." |
| POLL_CHOICE1_LABEL / POLL_CHOICE2_LABEL / ... / POLL_CHOICEN_LABEL | Text label for each poll choice (set when the tweet contains a poll) | "Yes" |
| POLL_CHOICE1_VOTES / POLL_CHOICE2_VOTES / ... / POLL_CHOICEN_VOTES | Raw vote count for each poll choice | "1234" |
| POLL_CHOICE1_PERCENT / POLL_CHOICE2_PERCENT / ... / POLL_CHOICEN_PERCENT | Rounded vote share (0–100) for each poll choice. Omitted when no votes have been cast yet. | "42" |
| POLL_CHOICE1_IMAGE / POLL_CHOICE2_IMAGE / ... / POLL_CHOICEN_IMAGE | Image URL for each poll choice. Only set on image polls; text-only polls expose labels alone. | "https://pbs.twimg.com/card_img/..." |
| POLL_TOTAL_VOTES | Total votes across all choices | "4521" |
| POLL_DURATION_MINUTES | Poll duration in minutes | "1440" |
| POLL_END_AT | Poll end time as epoch milliseconds (falls back to the raw ISO string if parsing fails) | "1757946600000" |
| POLL_IS_ENDED | Set to "true" once the poll has ended and counts are final | "true" |
| REPLY_POLL_* / QUOTED_POLL_* / RETWEET_POLL_* | Same poll fields (CHOICEN_LABEL/VOTES/PERCENT/IMAGE, TOTAL_VOTES, DURATION_MINUTES, END_AT, IS_ENDED) when the sub-tweet carries a poll | "Yes" / "1234" / ... |
| AUTHOR_FOLLOWING_COUNT | Author's following count | "1018" |
| REPLY_AUTHOR_ID | User ID of replied-to user | "14355836" |
| QUOTED_AUTHOR_ID | User ID of quoted user | "19995253" |
| IS_TWITTER_SEARCH | Whether tweet was found via Twitter search | "true" |
| REPLY_TWEET_LINK | URL to the parent tweet | "https://x.com/user/status/..." |
| QUOTED_TWEET_LINK | URL to the quoted tweet | "https://x.com/user/status/..." |
| RETWEET_TWEET_LINK | URL to the retweeted tweet | "https://x.com/user/status/..." |
| REPLY_IMAGE2 / REPLY_IMAGE3 / REPLY_IMAGE4 | Additional images in replied-to tweet | "https://pbs.twimg.com/media/..." |
| REPLY_VIDEO2 / REPLY_VIDEO3 / REPLY_VIDEO4 | Additional videos in replied-to tweet | "https://video.twimg.com/..." |
| QUOTED_IMAGE2 / QUOTED_IMAGE3 / QUOTED_IMAGE4 | Additional images in quoted tweet | "https://pbs.twimg.com/media/..." |
| QUOTED_VIDEO2 / QUOTED_VIDEO3 / QUOTED_VIDEO4 | Additional videos in quoted tweet | "https://video.twimg.com/..." |
| RETWEET_IMAGE2 / RETWEET_IMAGE3 / RETWEET_IMAGE4 | Additional images in retweeted tweet | "https://pbs.twimg.com/media/..." |
| RETWEET_VIDEO2 / RETWEET_VIDEO3 / RETWEET_VIDEO4 | Additional videos in retweeted tweet | "https://video.twimg.com/..." |
| QUOTED_AUTHOR_BIO | Bio of quoted user | "Building the future" |
| QUOTED_AUTHOR_CREATED_AT | Account creation date of quoted user | "2020-01-01T..." |
| QUOTED_AUTHOR_LOCATION | Location of quoted user | "New York" |
| QUOTED_AUTHOR_PROFILE_BANNER | Banner image of quoted user | "https://pbs.twimg.com/profile_banners/..." |
| QUOTED_AUTHOR_WEBSITE | Website of quoted user | "https://example.com" |
| QUOTED_AUTHOR_IS_BLUE_VERIFIED | Whether the quoted user has a blue checkmark | "true" |
| QUOTED_AUTHOR_VERIFIED_TYPE | Quoted user's verification type | "Business" / "Government" |
| QUOTED_AUTHOR_AFFILIATE_DESCRIPTION | Quoted user's affiliate badge description | "BAGS" |
| QUOTED_AUTHOR_AFFILIATE_BADGE_URL | Quoted user's affiliate badge image URL | "https://pbs.twimg.com/..." |
| QUOTED_AUTHOR_AFFILIATE_URL | Quoted user's affiliate link URL | "https://example.com" |
| QUOTED_AUTHOR_AFFILIATE_LABEL_TYPE | Quoted user's affiliate label type | "BusinessLabel" |
| RETWEET_AUTHOR_BIO | Bio of retweeted user | "Crypto enthusiast" |
| RETWEET_AUTHOR_CREATED_AT | Account creation date of retweeted user | "2019-06-01T..." |
| RETWEET_AUTHOR_LOCATION | Location of retweeted user | "Miami" |
| RETWEET_AUTHOR_PROFILE_BANNER | Banner image of retweeted user | "https://pbs.twimg.com/profile_banners/..." |
| RETWEET_AUTHOR_WEBSITE | Website of retweeted user | "https://example.com" |
| RETWEET_AUTHOR_IS_BLUE_VERIFIED | Whether the retweeted user has a blue checkmark | "true" |
| RETWEET_AUTHOR_VERIFIED_TYPE | Retweeted user's verification type | "Business" / "Government" |
| RETWEET_AUTHOR_AFFILIATE_DESCRIPTION | Retweeted user's affiliate badge description | "BAGS" |
| RETWEET_AUTHOR_AFFILIATE_BADGE_URL | Retweeted user's affiliate badge image URL | "https://pbs.twimg.com/..." |
| RETWEET_AUTHOR_AFFILIATE_URL | Retweeted user's affiliate link URL | "https://example.com" |
| RETWEET_AUTHOR_AFFILIATE_LABEL_TYPE | Retweeted user's affiliate label type | "BusinessLabel" |
| REPLY_AUTHOR_BIO | Bio of replied-to user | "DeFi builder" |
| REPLY_AUTHOR_CREATED_AT | Account creation date of replied-to user | "2018-03-15T..." |
| REPLY_AUTHOR_LOCATION | Location of replied-to user | "London" |
| REPLY_AUTHOR_PROFILE_BANNER | Banner image of replied-to user | "https://pbs.twimg.com/profile_banners/..." |
| REPLY_AUTHOR_WEBSITE | Website of replied-to user | "https://example.com" |
| REPLY_AUTHOR_IS_BLUE_VERIFIED | Whether the replied-to user has a blue checkmark | "true" |
| REPLY_AUTHOR_VERIFIED_TYPE | Replied-to user's verification type | "Business" / "Government" |
| REPLY_AUTHOR_AFFILIATE_DESCRIPTION | Replied-to user's affiliate badge description | "BAGS" |
| REPLY_AUTHOR_AFFILIATE_BADGE_URL | Replied-to user's affiliate badge image URL | "https://pbs.twimg.com/..." |
| REPLY_AUTHOR_AFFILIATE_URL | Replied-to user's affiliate link URL | "https://example.com" |
| REPLY_AUTHOR_AFFILIATE_LABEL_TYPE | Replied-to user's affiliate label type | "BusinessLabel" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TWEET",
"SUBTYPE": "NEW_TWEET",
"AUTHOR_ID": "17469289",
"AUTHOR_HANDLE": "nypost",
"AUTHOR_NAME": "New York Post",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/966372680306868224/60wfGe9e_normal.jpg",
"AUTHOR_FOLLOWERS_COUNT": "3736395",
"AUTHOR_BIO": "Breaking news, features and more from the NY Post.",
"AUTHOR_LOCATION": "New York, NY",
"AUTHOR_WEBSITE": "http://www.nypost.com",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_VERIFIED_TYPE": "Business",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/17469289/1444326181",
"AUTHOR_CREATED_AT": "Tue Nov 18 19:46:36 +0000 2008",
"TWEET_ID": "2043394712833241391",
"TWEET_TEXT": "Mamdani's trademark smug videos now undermining agenda: 'Might be a price to pay' https://trib.al/fSiLitC",
"TWEET_LINK": "https://x.com/nypost/status/2043394712833241391",
"IMAGE": "https://pbs.twimg.com/media/HFuYqHWXMAA-4j8.jpg",
"SOURCE_URL": "https://x.com/nypost/status/2043394712833241391",
"LABEL": "good animal news juicers",
"CATEGORY": "NEWS"
},
"_id": "2043394712833241391",
"type": "direct",
"title": "New York Post (@nypost) [good animal news juicers]",
"body": "Mamdani's trademark smug videos now undermining agenda: 'Might be a price to pay' https://trib.al/fSiLitC",
"image": "https://pbs.twimg.com/media/HFuYqHWXMAA-4j8.jpg",
"link": "https://x.com/nypost/status/2043394712833241391",
"icon": "https://pbs.twimg.com/profile_images/966372680306868224/60wfGe9e_normal.jpg",
"requireInteraction": true,
"time": 1776018238634,
"isCustom": true,
"info": {
"twitterId": "17469289",
"isReply": false,
"isSelfReply": false,
"isRetweet": false,
"isQuote": false
},
"suggestions": [],
"urls": []
}New post from a tracked TikTok creator, detected in real time from the creator's public embed. Two variants share this type: a video post (SUBTYPE "VIDEO", carrying a hot-linkable mp4) and a photo/slideshow post (SUBTYPE "PHOTO", carrying an image carousel). Contains author info, the caption and parsed hashtags, the cover thumbnail and video dimensions. Music, duration and engagement counts (plays/likes/comments) are intentionally not included — detection is embed-only. A contract address and label are added when the tracked account has one configured.
How to identify: tags.NEWS_TYPE === "TIKTOK_VIDEO"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| NEWS_TYPE | Event type discriminator (added by the feed) | "TIKTOK_VIDEO" |
| SUBTYPE | Post kind: "VIDEO" (mp4) or "PHOTO" (image slideshow) | "VIDEO" / "PHOTO" |
| AUTHOR_HANDLE | TikTok username (normalized, lowercase, no @) | "khaby.lame" |
| AUTHOR_NAME | Creator display name / nickname | "Khabane lame" |
| AUTHOR_ID | TikTok user ID | "6852563716200645637" |
| AUTHOR_ICON | Creator avatar URL (also the card icon) | "https://p16-sign.tiktokcdn-us.com/..." |
| AUTHOR_VERIFIED | Whether the creator is verified (always set) | "true" / "false" |
| AUTHOR_FOLLOWERS_COUNT | Creator follower count (always set) | "162000000" |
| AUTHOR_BIO | Creator bio / signature (when set) | "If you want to laugh..." |
| VIDEO_ID | TikTok post ID (also the message _id) | "7300000000000000000" |
| POST_TEXT | Post caption / description (also the body) | "why would you do this? 🤔" |
| POST_URL | Canonical URL to the post (same as link and SOURCE_URL) | "https://www.tiktok.com/@khaby.lame/video/7300..." |
| PUBLISHED_AT | Publish time (ISO-8601, derived from the post ID) | "2025-07-01T12:00:00Z" |
| WIDTH / HEIGHT / RATIO | Video dimensions and aspect ratio (when the embed provides them) | "1080" / "1920" / "9:16" |
| HASHTAGS | Comma-separated hashtags parsed from the caption (omitted if none) | "funny,comedy,fyp" |
| VIDEO | Hot-linkable mp4 URL — SUBTYPE "VIDEO" only | "https://v16m.tiktokcdn-us.com/....mp4" |
| VIDEO_THUMBNAIL | Cover thumbnail used as the video poster — "VIDEO" only | "https://p16-sign.tiktokcdn-us.com/....jpeg" |
| VIDEO_COVER | Static cover image — "VIDEO" only | "https://p16-sign.tiktokcdn-us.com/....jpeg" |
| VIDEO_DYNAMIC_COVER | Animated cover image (webp) — "VIDEO" only, when available | "https://p16-sign.tiktokcdn-us.com/....webp" |
| POST_TITLE | Headline shown above the images — SUBTYPE "PHOTO" only, when present | "My photo post title" |
| IMAGE | Cover image (video posts); first slide (photo posts) | "https://p16-sign.tiktokcdn-us.com/....jpeg" |
| IMAGE2 / IMAGE3 / ... / IMAGEN | Additional slideshow images — SUBTYPE "PHOTO" only | "https://p16-sign.tiktokcdn-us.com/....jpeg" |
| IMAGE_COUNT | Number of slideshow images — SUBTYPE "PHOTO" only | "3" |
| SOURCE_URL | Post URL (added by the feed; same as POST_URL) | "https://www.tiktok.com/@khaby.lame/video/7300..." |
| LABEL | Label set on the tracked TikTok account (present when it adds information) | "$KHABY" |
| CONTRACT_ADDRESS | Contract address configured on the tracked account (or matched from your keyword→CA mappings) | "8HxW9Z3YT1gXgQ...pump" |
| CONTRACT_ADDRESS_LABEL | Display label for the contract address (present when CONTRACT_ADDRESS is) | "User-labelled CA" |
| PREFERRED_TRADING_URL | Your preferred trading URL for the contract address (present when CONTRACT_ADDRESS is) | "https://photon-sol.tinyastro.io/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"NEWS_TYPE": "TIKTOK_VIDEO",
"SUBTYPE": "VIDEO",
"AUTHOR_HANDLE": "khaby.lame",
"AUTHOR_NAME": "Khabane lame",
"AUTHOR_ID": "6852563716200645637",
"AUTHOR_ICON": "https://p16-sign.tiktokcdn-us.com/example_avatar.jpeg",
"AUTHOR_VERIFIED": "true",
"AUTHOR_FOLLOWERS_COUNT": "162000000",
"VIDEO_ID": "7300000000000000000",
"POST_TEXT": "why would you do this? 🤔 #funny #comedy #fyp",
"POST_URL": "https://www.tiktok.com/@khaby.lame/video/7300000000000000000",
"PUBLISHED_AT": "2025-07-01T12:00:00Z",
"WIDTH": "1080",
"HEIGHT": "1920",
"RATIO": "9:16",
"HASHTAGS": "funny,comedy,fyp",
"VIDEO": "https://v16m.tiktokcdn-us.com/example_video.mp4",
"VIDEO_THUMBNAIL": "https://p16-sign.tiktokcdn-us.com/example_cover.jpeg",
"VIDEO_COVER": "https://p16-sign.tiktokcdn-us.com/example_cover.jpeg",
"IMAGE": "https://p16-sign.tiktokcdn-us.com/example_cover.jpeg",
"SOURCE_URL": "https://www.tiktok.com/@khaby.lame/video/7300000000000000000"
},
"_id": "7300000000000000000",
"type": "direct",
"title": "🎬 New TikTok from Khabane lame (@khaby.lame)",
"body": "why would you do this? 🤔 #funny #comedy #fyp",
"image": "https://p16-sign.tiktokcdn-us.com/example_cover.jpeg",
"video": "https://v16m.tiktokcdn-us.com/example_video.mp4",
"link": "https://www.tiktok.com/@khaby.lame/video/7300000000000000000",
"icon": "https://p16-sign.tiktokcdn-us.com/example_avatar.jpeg",
"requireInteraction": true,
"time": 1751371200000,
"isCustom": true,
"suggestions": [],
"urls": []
}New article from a tracked news publisher (currently New York Post and BBC News), detected in real time from the publisher's RSS feed. Carries the publisher identity, the headline, the deck/excerpt and best-effort full text, the lead image, the section, byline and publish time. The top-level "source" is the coarse "Blogs" category; the publisher's own name and icon live in the tags.
How to identify: tags.NEWS_TYPE === "PUBLISHER_ARTICLE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| NEWS_TYPE | Event type discriminator (added by the feed) | "PUBLISHER_ARTICLE" |
| SOURCE_ID | Publisher identifier | "NEW_YORK_POST" / "BBC" |
| SOURCE_NAME | Publisher display name | "New York Post" / "BBC News" |
| SOURCE_ICON | Publisher logo URL (used as the card icon) | "https://nypost.com/wp-content/.../icon-96x96.png" |
| SOURCE_BASE_URL | Publisher home URL (distinct from the article URL) | "https://nypost.com" |
| TITLE | Article headline (also the top-level title) | "Bitcoin surges past $150k as ETF inflows hit record" |
| URL | Article URL (same as the top-level url and SOURCE_URL) | "https://nypost.com/2026/07/16/business/..." |
| DECK | Short subheadline / excerpt — what notifications show, and the message body | "Bitcoin hit a new all-time high on Tuesday..." |
| TEXT | Best full article text the feed carries (falls back to the excerpt) | "Bitcoin hit a new all-time high on Tuesday as spot ETF inflows..." |
| IMAGE | Lead image URL (when the feed carries one) | "https://nypost.com/.../article-image.jpg" |
| SECTION | Site section (the feed's section for BBC, URL-derived for NY Post) | "business" / "us-news" |
| BYLINE | Article byline / author (when present) | "John Smith" |
| ARTICLE_ID | Publisher's stable article ID (when present) | "123456789" |
| GUID | Feed GUID (when present) | "https://nypost.com/?p=123456789" |
| PUBLISHED_AT | Publish time (ISO-8601; live/modified time, else pubDate) | "2026-07-16T15:46:05Z" |
| SOURCE_URL | Article URL (added by the feed; same as URL) | "https://nypost.com/2026/07/16/business/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"NEWS_TYPE": "PUBLISHER_ARTICLE",
"SOURCE_ID": "NEW_YORK_POST",
"SOURCE_NAME": "New York Post",
"SOURCE_ICON": "https://nypost.com/wp-content/themes/nypost/static/images/favicons/icon-96x96.png",
"SOURCE_BASE_URL": "https://nypost.com",
"TITLE": "Bitcoin surges past $150k as ETF inflows hit record",
"URL": "https://nypost.com/2026/07/16/business/bitcoin-surges-past-150k-as-etf-inflows-hit-record/",
"DECK": "Bitcoin hit a new all-time high on Tuesday as spot ETF inflows reached record levels.",
"TEXT": "Bitcoin hit a new all-time high on Tuesday as spot ETF inflows reached record levels, with analysts pointing to sustained institutional demand.",
"IMAGE": "https://nypost.com/wp-content/uploads/sites/2/2026/07/bitcoin.jpg",
"SECTION": "business",
"BYLINE": "John Smith",
"ARTICLE_ID": "123456789",
"GUID": "https://nypost.com/?p=123456789",
"PUBLISHED_AT": "2026-07-16T15:46:05Z",
"SOURCE_URL": "https://nypost.com/2026/07/16/business/bitcoin-surges-past-150k-as-etf-inflows-hit-record/"
},
"_id": "845201933",
"source": "Blogs",
"title": "Bitcoin surges past $150k as ETF inflows hit record",
"body": "Bitcoin hit a new all-time high on Tuesday as spot ETF inflows reached record levels.",
"url": "https://nypost.com/2026/07/16/business/bitcoin-surges-past-150k-as-etf-inflows-hit-record/",
"image": "https://nypost.com/wp-content/uploads/sites/2/2026/07/bitcoin.jpg",
"suggestions": [],
"time": 1784216765000
}Triggered when a tracked tweet's view count crosses a milestone multiplier (2x, 5x, 10x, etc.). Contains the same fields as a regular tweet plus the milestone threshold and current view count.
How to identify: tags.TYPE === "TWEET_VIEWS_MILESTONE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TWEET_VIEWS_MILESTONE" |
| MILESTONE_THRESHOLD | Views multiplier that was crossed | "2" / "5" / "10" |
| VIEW_COUNT | Current view count at time of milestone | "20034" |
| AUTHOR_ID | Twitter user ID | "76766018" |
| AUTHOR_HANDLE | Twitter username | "Dexerto" |
| AUTHOR_NAME | Display name | "Dexerto" |
| AUTHOR_ICON | Profile picture URL | "https://pbs.twimg.com/..." |
| AUTHOR_FOLLOWERS_COUNT | Author's follower count | "1322255" |
| TWEET_ID | Tweet ID | "2041246055941980628" |
| TWEET_TEXT | Tweet content | "A jar of Nutella floating..." |
| TWEET_LINK | URL to tweet | "https://x.com/Dexerto/status/..." |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Attached image URLs | "https://pbs.twimg.com/media/..." |
| VIDEO | Video URL if present | "https://video.twimg.com/..." |
| VIDEO_THUMBNAIL | Video thumbnail | "https://pbs.twimg.com/..." |
| LABEL | Account label if set | "News Outlet" |
| CATEGORY | Account category | "IMPORTANT" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TWEET_VIEWS_MILESTONE",
"AUTHOR_ID": "76766018",
"AUTHOR_HANDLE": "Dexerto",
"AUTHOR_NAME": "Dexerto",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1714301666445402112/5U5myYFv_normal.jpg",
"AUTHOR_FOLLOWERS_COUNT": "1322255",
"AUTHOR_LOCATION": "press[at]dexerto.com",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_VERIFIED_TYPE": "Business",
"AUTHOR_WEBSITE": "https://www.dexerto.com/",
"AUTHOR_BIO": "The leading source for influencer, streamer, gaming, and viral content",
"TWEET_ID": "2041246055941980628",
"TWEET_TEXT": "A jar of Nutella floating inside NASA's Artemis spacecraft is going viral as the perfect accidental ad",
"TWEET_LINK": "https://x.com/Dexerto/status/2041246055941980628",
"VIDEO": "https://video.twimg.com/amplify_video/2041227128142696448/vid/avc1/1920x1036/CCWwMeZr6yX4MeKs.mp4",
"VIEW_COUNT": "20034",
"MILESTONE_THRESHOLD": "2",
"SOURCE_URL": "https://x.com/Dexerto/status/2041246055941980628",
"LABEL": null,
"CATEGORY": "IMPORTANT"
},
"_id": "2041246055941980628",
"type": "direct",
"title": "🎯 Tweet views increased by 2x",
"body": "A jar of Nutella floating inside NASA's Artemis spacecraft is going viral as the perfect accidental ad",
"link": "https://x.com/Dexerto/status/2041246055941980628",
"icon": "https://pbs.twimg.com/profile_images/1714301666445402112/5U5myYFv_normal.jpg",
"requireInteraction": true,
"time": 1775507131438,
"isCustom": true,
"info": {
"twitterId": "76766018",
"isReply": false,
"isSelfReply": false,
"isRetweet": false,
"isQuote": false
},
"suggestions": [],
"urls": []
}Triggered when a tracked account follows another user. Contains info about both the follower and the followed account.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "FOLLOW"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "FOLLOW" |
| AUTHOR_ID | Follower's user ID | "1176026136117166080" |
| AUTHOR_HANDLE | Who followed | "rawsalerts" |
| AUTHOR_NAME | Their display name | "R A W S A L E R T S" |
| AUTHOR_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Author's account creation date | "Mon Sep 23 06:51:06 +0000 2019" |
| AUTHOR_FOLLOWERS_COUNT | Author's follower count | "1691100" |
| AUTHOR_FOLLOWING_COUNT | Author's following count | "42" |
| AUTHOR_BIO | Author's bio | "RawsAlerts is your go-to source for fast, accurate breaking news" |
| AUTHOR_LOCATION | Author's location | "United states" |
| AUTHOR_WEBSITE | Author's website | "https://polymarket.com" |
| AUTHOR_PROFILE_BANNER | Author's banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Author's blue verified status | "true" |
| AUTHOR_VERIFIED_TYPE | Author's verification type | "Business" |
| AUTHOR_AFFILIATE_DESCRIPTION | Author's affiliate org description | "Polymarket" |
| AUTHOR_AFFILIATE_BADGE_URL | Author's affiliate badge image URL | "https://pbs.twimg.com/..." |
| AUTHOR_AFFILIATE_URL | Author's affiliate link URL | "https://twitter.com/Polymarket" |
| AUTHOR_AFFILIATE_LABEL_TYPE | Author's affiliate label type | "BusinessLabel" |
| FOLLOWED_HANDLE | Who was followed | "Real69Minutes" |
| FOLLOWED_NAME | Their display name | "69 Minutes" |
| FOLLOWED_ID | Followed user's ID | "1814788640415096834" |
| FOLLOWED_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| FOLLOWED_BIO | Their bio text | "Welcome to 69 Minutes hosted by Alex Stone!" |
| FOLLOWED_BIO_TRANSLATED | Translated bio if non-English | "... [Translated]" |
| FOLLOWED_BANNER | Their banner image URL | "https://pbs.twimg.com/profile_banners/..." |
| FOLLOWED_FOLLOWERS | Their follower count | "7401" |
| FOLLOWED_FOLLOWING_COUNT | Their following count | "371" |
| FOLLOWED_URL | Their website if set | "http://www.69minutes.media" |
| FOLLOWED_LOCATION | Their location if set | "Only on X" |
| FOLLOWED_CREATED_AT | When followed account was created | "1721514315000" |
| FOLLOWED_IS_BLUE_VERIFIED | Followed user's blue verified status | "true" |
| FOLLOWED_VERIFIED_TYPE | Followed user's verification type | "blue" |
| CONTRACT_ADDRESS | CA detected in bio | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "FOLLOW",
"AUTHOR_ID": "1176026136117166080",
"AUTHOR_HANDLE": "rawsalerts",
"AUTHOR_NAME": "R A W S A L E R T S",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1999972200779005953/JP18SAS8.jpg",
"AUTHOR_CREATED_AT": "Mon Sep 23 06:51:06 +0000 2019",
"AUTHOR_FOLLOWERS_COUNT": "1691100",
"AUTHOR_BIO": "RawsAlerts is your go-to source for fast, accurate breaking news Powered by @Polymarket. More coverage on @RawsGlobal",
"AUTHOR_LOCATION": "United states ",
"AUTHOR_WEBSITE": "https://polymarket.com",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_AFFILIATE_DESCRIPTION": "Polymarket",
"FOLLOWED_HANDLE": "Real69Minutes",
"FOLLOWED_NAME": "69 Minutes",
"FOLLOWED_ID": "1814788640415096834",
"FOLLOWED_ICON": "https://pbs.twimg.com/profile_images/1892720321012101120/L7czvuFv.jpg",
"FOLLOWED_BIO": "Welcome to 69 Minutes hosted by Alex Stone!",
"FOLLOWED_BANNER": "https://pbs.twimg.com/profile_banners/1814788640415096834/1738901036",
"FOLLOWED_FOLLOWERS": "7401",
"FOLLOWED_LOCATION": "Only on X",
"FOLLOWED_URL": "http://www.69minutes.media",
"FOLLOWED_IS_BLUE_VERIFIED": "true",
"SOURCE_URL": "https://x.com/Real69Minutes",
"CATEGORY": "NEWS"
},
"_id": "rawsalerts-TWITTER_FOLLOW-real69minutes",
"source": "Terminal",
"title": "👤 @rawsalerts (R A W S A L E R T S) followed @Real69Minutes (69 Minutes)",
"body": "\n\n📝 Welcome to 69 Minutes hosted by Alex Stone!\n\n👥 7401 followers\n📍 Only on X\n🌐 http://www.69minutes.media",
"icon": "https://pbs.twimg.com/profile_images/1999972200779005953/JP18SAS8.jpg",
"url": "https://x.com/Real69Minutes",
"time": 1775933137114,
"image": "https://pbs.twimg.com/profile_banners/1814788640415096834/1738901036"
}Triggered when a tracked account unfollows another user. Same structure as Follow Event.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "UNFOLLOW"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "UNFOLLOW" |
| AUTHOR_ID | Unfollower's user ID | "44553913" |
| AUTHOR_HANDLE | Who unfollowed | "Nate_Esparza" |
| AUTHOR_NAME | Their display name | "Nate Esparza" |
| AUTHOR_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Author's account creation date | "Thu Jun 04 05:29:03 +0000 2009" |
| AUTHOR_FOLLOWERS_COUNT | Author's follower count | "55911" |
| AUTHOR_BIO | Author's bio | "Ads Product @X" |
| AUTHOR_LOCATION | Author's location | "CU-Boulder" |
| AUTHOR_WEBSITE | Author's website | "https://business.x.com/..." |
| AUTHOR_PROFILE_BANNER | Author's banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Author's blue verified status | "true" |
| AUTHOR_AFFILIATE_DESCRIPTION | Author's affiliate org description | "X" |
| AUTHOR_AFFILIATE_BADGE_URL | Author's affiliate badge image URL | "https://pbs.twimg.com/..." |
| AUTHOR_AFFILIATE_URL | Author's affiliate link URL | "https://twitter.com/X" |
| AUTHOR_AFFILIATE_LABEL_TYPE | Author's affiliate label type | "BusinessLabel" |
| FOLLOWED_ID | Unfollowed user's ID | "3096147528" |
| FOLLOWED_HANDLE | Who was unfollowed | "dom_lucre" |
| FOLLOWED_NAME | Their display name | "Dom Lucre | Breaker of Narratives" |
| FOLLOWED_ICON | Their avatar URL | "https://pbs.twimg.com/..." |
| FOLLOWED_BIO | Their bio text | "White House Featured Journalist..." |
| FOLLOWED_BIO_TRANSLATED | Translated bio if non-English | "... [Translated]" |
| FOLLOWED_BANNER | Their banner image URL | "https://pbs.twimg.com/profile_banners/..." |
| FOLLOWED_FOLLOWERS | Their follower count | "1694165" |
| FOLLOWED_FOLLOWING_COUNT | Their following count | "3106" |
| FOLLOWED_LOCATION | Their location if set | "Miami, FL" |
| FOLLOWED_URL | Their website if set | "https://domlucre.org" |
| FOLLOWED_CREATED_AT | When unfollowed account was created | "1426681046000" |
| FOLLOWED_IS_BLUE_VERIFIED | Unfollowed user's blue verified status | "true" |
| FOLLOWED_VERIFIED_TYPE | Unfollowed user's verification type | "blue" |
| CONTRACT_ADDRESS | CA detected in bio | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
| SOURCE_URL | Profile URL | "https://x.com/dom_lucre" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "UNFOLLOW",
"AUTHOR_ID": "44553913",
"AUTHOR_HANDLE": "Nate_Esparza",
"AUTHOR_NAME": "Nate Esparza",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2036562525735755776/39NvLFbs.jpg",
"AUTHOR_CREATED_AT": "Thu Jun 04 05:29:03 +0000 2009",
"AUTHOR_FOLLOWERS_COUNT": "55911",
"AUTHOR_BIO": "Ads Product @X | CU-Boulder Alumni Lead | Tech | Broncos, Avalanche, Nuggets | Opinions are my own",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_AFFILIATE_DESCRIPTION": "X",
"AUTHOR_AFFILIATE_BADGE_URL": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg",
"AUTHOR_AFFILIATE_URL": "https://twitter.com/X",
"AUTHOR_AFFILIATE_LABEL_TYPE": "BusinessLabel",
"FOLLOWED_ID": "3096147528",
"FOLLOWED_HANDLE": "dom_lucre",
"FOLLOWED_NAME": "Dom Lucre | Breaker of Narratives",
"FOLLOWED_ICON": "https://pbs.twimg.com/profile_images/1997374530206003200/6NCXjZo7.jpg",
"FOLLOWED_BIO": "White House Featured Journalist | The World Stage Is Exposed Here, Let's Break It. Business@domlucre.org",
"FOLLOWED_BANNER": "https://pbs.twimg.com/profile_banners/3096147528/1724367433",
"FOLLOWED_FOLLOWERS": "1694165",
"FOLLOWED_LOCATION": "Miami, FL",
"FOLLOWED_URL": "https://domlucre.org",
"FOLLOWED_IS_BLUE_VERIFIED": "true",
"FOLLOWED_VERIFIED_TYPE": "blue",
"SOURCE_URL": "https://x.com/dom_lucre",
"CATEGORY": "CUSTOM"
},
"_id": "nate_esparza-TWITTER_UNFOLLOW-dom_lucre",
"source": "Terminal",
"title": "👤❌ @Nate_Esparza (Nate Esparza) unfollowed @dom_lucre (Dom Lucre | Breaker of Narratives)",
"body": "\n\n📝 White House Featured Journalist | The World Stage Is Exposed Here, Let's Break It. Business@domlucre.org\n\n👥 1694165 followers\n📍 Miami, FL\n🌐 https://domlucre.org",
"icon": "https://pbs.twimg.com/profile_images/2036562525735755776/39NvLFbs.jpg",
"url": "https://x.com/dom_lucre",
"time": 1775934169108,
"image": "https://pbs.twimg.com/profile_banners/3096147528/1724367433"
}Triggered when a tracked account changes their bio. Includes both old and new bio text.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "BIO_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "BIO_CHANGE" |
| AUTHOR_ID | User ID | "16573941" |
| AUTHOR_HANDLE | Username | "netflix" |
| AUTHOR_NAME | Display name | "Netflix" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1223007377000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "26073545" |
| AUTHOR_LOCATION | Location | "California, USA" |
| AUTHOR_WEBSITE | Website | "https://netflix.com" |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_VERIFIED_TYPE | Verification type | "business" |
| OLD_BIO | Previous bio text | "it's xo kitty week ✨" |
| NEW_BIO | New bio text | "FURY VS MAKHMUDOV" |
| OLD_BIO_TRANSLATED | Old bio translation | "... [Translated]" |
| NEW_BIO_TRANSLATED | New bio translation | "... [Translated]" |
| CONTRACT_ADDRESS | CA detected in new bio | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "BIO_CHANGE",
"AUTHOR_ID": "16573941",
"AUTHOR_HANDLE": "netflix",
"AUTHOR_NAME": "Netflix",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1996301804053868544/Xrwvbe1q.jpg",
"AUTHOR_CREATED_AT": "1223007377000",
"AUTHOR_FOLLOWERS_COUNT": "26073545",
"AUTHOR_LOCATION": "California, USA",
"AUTHOR_WEBSITE": "https://netflix.com",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/16573941/1775920368",
"AUTHOR_VERIFIED_TYPE": "business",
"OLD_BIO": "it's xo kitty week ✨",
"NEW_BIO": "FURY VS MAKHMUDOV",
"SOURCE_URL": "https://x.com/netflix",
"CATEGORY": "COMPANIES"
},
"_id": "netflix-TWITTER_BIO_CHANGE",
"source": "Terminal",
"title": "📝 Netflix (@netflix) updated bio",
"body": "Old: it's xo kitty week ✨\n\nNew: FURY VS MAKHMUDOV",
"icon": "https://pbs.twimg.com/profile_images/1996301804053868544/Xrwvbe1q.jpg",
"url": "https://x.com/netflix",
"time": 1775932752642
}Triggered when a tracked account changes their display name.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "NAME_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "NAME_CHANGE" |
| AUTHOR_ID | User ID | "46302096" |
| AUTHOR_HANDLE | Username | "JoeyMannarino" |
| AUTHOR_NAME | Display name (new name) | "Joey Mannarino" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1244690436000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "672187" |
| AUTHOR_BIO | Bio | "Co-Founder of The Overton Institute..." |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| OLD_NAME | Previous display name | "Joey Mannarino 🇺🇸" |
| NEW_NAME | New display name | "Joey Mannarino" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "NAME_CHANGE",
"AUTHOR_ID": "46302096",
"AUTHOR_HANDLE": "JoeyMannarino",
"AUTHOR_NAME": "Joey Mannarino",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2036192870739144704/1oSuhME__normal.jpg",
"AUTHOR_CREATED_AT": "1244690436000",
"AUTHOR_FOLLOWERS_COUNT": "672187",
"AUTHOR_BIO": "Co-Founder of The Overton Institute. American citizen. Political strategist & commentator working with conservative movements in the US & EU.",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/46302096/1760846788",
"OLD_NAME": "Joey Mannarino 🇺🇸",
"NEW_NAME": "Joey Mannarino",
"SOURCE_URL": "https://x.com/JoeyMannarino",
"CATEGORY": "CUSTOM"
},
"_id": "joeymannarino-TWITTER_NAME_CHANGE",
"source": "Terminal",
"title": "✏️ Joey Mannarino (@JoeyMannarino) updated display name",
"body": "Old: Joey Mannarino 🇺🇸\n\nNew: Joey Mannarino",
"icon": "https://pbs.twimg.com/profile_images/2036192870739144704/1oSuhME__normal.jpg",
"url": "https://x.com/JoeyMannarino",
"time": 1775939310565
}Triggered when a tracked account changes their profile picture.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "PROFILE_PICTURE_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "PROFILE_PICTURE_CHANGE" |
| AUTHOR_ID | User ID | "1565089861245313027" |
| AUTHOR_HANDLE | Username | "iruletheworldmo" |
| AUTHOR_NAME | Display name | "🍓🍓🍓" |
| AUTHOR_ICON | Avatar URL (new avatar) | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1661981517000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "101033" |
| AUTHOR_BIO | Bio | "GPT6 IS ASI" |
| AUTHOR_LOCATION | Location | "sams basement" |
| AUTHOR_WEBSITE | Website | "https://mstrawberryman-ui.github.io/..." |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Blue verified status | "true" |
| AUTHOR_VERIFIED_TYPE | Verification type | "blue" |
| OLD_PROFILE_PICTURE | Previous avatar URL | "https://pbs.twimg.com/..." |
| NEW_PROFILE_PICTURE | New avatar URL | "https://pbs.twimg.com/..." |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "PROFILE_PICTURE_CHANGE",
"AUTHOR_ID": "1565089861245313027",
"AUTHOR_HANDLE": "iruletheworldmo",
"AUTHOR_NAME": "🍓🍓🍓",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"AUTHOR_CREATED_AT": "1661981517000",
"AUTHOR_FOLLOWERS_COUNT": "101033",
"AUTHOR_BIO": "GPT6 IS ASI",
"AUTHOR_LOCATION": "sams basement ",
"AUTHOR_WEBSITE": "https://mstrawberryman-ui.github.io/focus-reader-/",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/1565089861245313027/1764959776",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_VERIFIED_TYPE": "blue",
"OLD_PROFILE_PICTURE": "https://pbs.twimg.com/profile_images/1997010263585783808/DCNgEAb8.jpg",
"NEW_PROFILE_PICTURE": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"SOURCE_URL": "https://x.com/iruletheworldmo",
"CATEGORY": "CUSTOM"
},
"_id": "iruletheworldmo-TWITTER_PROFILE_PICTURE_CHANGE",
"source": "Terminal",
"title": "🖼️ 🍓🍓🍓 (@iruletheworldmo) updated profile picture",
"body": "Profile Image Changed",
"icon": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"image": "https://pbs.twimg.com/profile_images/2043044866507325440/j-KzMV1i.jpg",
"url": "https://x.com/iruletheworldmo",
"time": 1775934829246
}Triggered when a tracked account changes their profile banner.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "BANNER_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "BANNER_CHANGE" |
| AUTHOR_ID | User ID | "1598253668175847425" |
| AUTHOR_HANDLE | Username | "onusoz" |
| AUTHOR_NAME | Display name | "Onur Solmaz" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1669888391000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "4419" |
| AUTHOR_BIO | Bio | "Maintainer @openclaw, Founding Engineer @textcortex..." |
| AUTHOR_WEBSITE | Website | "https://solmaz.io" |
| AUTHOR_PROFILE_BANNER | Banner URL (new banner) | "https://pbs.twimg.com/profile_banners/..." |
| OLD_BANNER | Previous banner URL (empty string if no previous banner) | "" |
| NEW_BANNER | New banner URL | "https://pbs.twimg.com/profile_banners/..." |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "BANNER_CHANGE",
"AUTHOR_ID": "1598253668175847425",
"AUTHOR_HANDLE": "onusoz",
"AUTHOR_NAME": "Onur Solmaz",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1998282426783875072/AD1wK-0c_normal.jpg",
"AUTHOR_CREATED_AT": "1669888391000",
"AUTHOR_FOLLOWERS_COUNT": "4419",
"AUTHOR_BIO": "Maintainer @openclaw, Founding Engineer @textcortex. Trying to define Agentic Engineering",
"AUTHOR_WEBSITE": "https://solmaz.io",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/1598253668175847425/1775932911",
"OLD_BANNER": "",
"NEW_BANNER": "https://pbs.twimg.com/profile_banners/1598253668175847425/1775932911",
"SOURCE_URL": "https://x.com/onusoz",
"CATEGORY": "CUSTOM"
},
"_id": "onusoz-TWITTER_BANNER_CHANGE",
"source": "Terminal",
"title": "🎨 Onur Solmaz (@onusoz) updated banner",
"body": "Profile banner has been changed",
"icon": "https://pbs.twimg.com/profile_images/1998282426783875072/AD1wK-0c_normal.jpg",
"image": "https://pbs.twimg.com/profile_banners/1598253668175847425/1775932911",
"url": "https://x.com/onusoz",
"time": 1775932912287
}Triggered when a tracked account deletes a tweet that was previously captured.
How to identify: tags.TYPE === "TWEET" && tags.SUBTYPE === "DELETED_TWEET"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TWEET" |
| SUBTYPE | Event type | "DELETED_TWEET" |
| AUTHOR_ID | Twitter user ID | "1786465176113561600" |
| AUTHOR_HANDLE | Username | "StrategyMaxi" |
| AUTHOR_NAME | Display name | "100% Strategy" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1714761475000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "10041" |
| AUTHOR_BIO | Bio | "Strategy Maxi - All In $MSTR" |
| AUTHOR_LOCATION | Location | "Strategy" |
| AUTHOR_IS_BLUE_VERIFIED | Blue verified status | "true" |
| AUTHOR_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| TWEET_ID | ID of deleted tweet | "2043389521816097190" |
| DELETED_URL | URL of deleted tweet | "https://x.com/StrategyMaxi/status/..." |
| DELETED_CONTENT | Raw original content (includes RT prefix for retweets) | "I blame on ideological Bitcoiners..." |
| TWEET_TEXT | Tweet content of deleted tweet | "I blame on ideological Bitcoiners..." |
| TWEET_TEXT_TRANSLATED | Translation if non-English | "... [Translated]" |
| SOURCE_URL | URL to the deleted tweet | "https://x.com/StrategyMaxi/status/..." |
| IS_REPLY | Was it a reply | "true" / "false" |
| IS_QUOTE | Was it a quote | "true" / "false" |
| IS_RETWEET | Was it a retweet | "true" / "false" |
| QUOTED_AUTHOR_HANDLE | Username of quoted user | "glove" |
| QUOTED_AUTHOR_NAME | Name of quoted user | "G. Love" |
| QUOTED_AUTHOR_ICON | Avatar of quoted user | "https://pbs.twimg.com/..." |
| QUOTED_TWEET_ID | ID of quoted tweet | "2043047396322451700" |
| QUOTED_TWEET_TEXT | Content of quoted tweet | "I had a really tough day..." |
| QUOTED_TWEET_TEXT_TRANSLATED | Translated quoted tweet | "... [Translated]" |
| QUOTED_TWEET_LINK | URL to quoted tweet | "https://x.com/glove/status/..." |
| QUOTED_AUTHOR_CREATED_AT | Quoted author's account creation date | "Tue Feb 03 19:21:52 +0000 2009" |
| QUOTED_AUTHOR_FOLLOWERS_COUNT | Quoted author's follower count | "65621" |
| QUOTED_AUTHOR_BIO | Quoted author's bio | "My New album..." |
| QUOTED_AUTHOR_LOCATION | Quoted author's location | "Philly, PA!" |
| QUOTED_AUTHOR_PROFILE_BANNER | Quoted author's banner | "https://pbs.twimg.com/profile_banners/..." |
| QUOTED_AUTHOR_WEBSITE | Quoted author's website | "https://ffm.bio/..." |
| REPLY_AUTHOR_HANDLE | Username of replied-to user | "other_user" |
| REPLY_AUTHOR_NAME | Name of replied-to user | "Other User" |
| REPLY_TWEET_TEXT | Content of replied-to tweet | "Original reply text..." |
| REPLY_TWEET_TEXT_TRANSLATED | Translated reply tweet | "... [Translated]" |
| RETWEET_AUTHOR_HANDLE | Username of retweeted user | "magills_" |
| RETWEET_AUTHOR_NAME | Name of retweeted user | "Magills" |
| RETWEET_AUTHOR_ICON | Avatar of retweeted user | "https://pbs.twimg.com/..." |
| RETWEET_TWEET_ID | ID of retweeted tweet | "2043346264822010275" |
| RETWEET_TWEET_TEXT | Content of retweeted tweet | "Retweeted content..." |
| RETWEET_TWEET_TEXT_TRANSLATED | Translated retweet | "... [Translated]" |
| RETWEET_TWEET_LINK | URL to retweeted tweet | "https://x.com/magills_/status/..." |
| RETWEET_AUTHOR_CREATED_AT | Retweeted author's account creation date | "Mon Jan 02 02:26:35 +0000 2017" |
| RETWEET_AUTHOR_FOLLOWERS_COUNT | Retweeted author's follower count | "38064" |
| RETWEET_AUTHOR_BIO | Retweeted author's bio | "I fix broken buildings..." |
| RETWEET_AUTHOR_LOCATION | Retweeted author's location | "The Midwest" |
| RETWEET_AUTHOR_PROFILE_BANNER | Retweeted author's banner | "https://pbs.twimg.com/profile_banners/..." |
| RETWEET_AUTHOR_IS_BLUE_VERIFIED | Retweeted author's blue verified status | "true" |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Images from deleted tweet | "https://pbs.twimg.com/media/..." |
| VIDEO | Video from deleted tweet | "https://video.twimg.com/..." |
| VIDEO_THUMBNAIL | Video thumbnail | "https://pbs.twimg.com/..." |
| CONTRACT_ADDRESS | CA if detected in tweet | "Dde2MApjiq...pump" |
| CHAIN | Blockchain if CA detected | "SOL" |
| LABEL | Account label (user-defined) | "Alpha Trader" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TWEET",
"SUBTYPE": "DELETED_TWEET",
"AUTHOR_ID": "1786465176113561600",
"AUTHOR_HANDLE": "StrategyMaxi",
"AUTHOR_NAME": "100% Strategy",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2042056285622038532/bc6m9iR6_normal.jpg",
"AUTHOR_CREATED_AT": "1714761475000",
"AUTHOR_FOLLOWERS_COUNT": "10041",
"AUTHOR_BIO": "Strategy Maxi - All In $MSTR",
"AUTHOR_LOCATION": "Strategy",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_BANNER": "https://pbs.twimg.com/profile_banners/1786465176113561600/1774364739",
"TWEET_ID": "2043389521816097190",
"DELETED_URL": "https://x.com/StrategyMaxi/status/2043389521816097190",
"DELETED_CONTENT": "I blame on ideological Bitcoiners preaching self custody.\n\nTime to normalize the trust in custodians.\n\nWe have rise of AI being efficient in hacking and etc.\n\nCustodians will outperform self custody wallets in cybersecurity as custodians will have access to cutting edge AI. https://t.co/Qh5rpWWpl0",
"TWEET_TEXT": "I blame on ideological Bitcoiners preaching self custody.\n\nTime to normalize the trust in custodians.\n\nWe have rise of AI being efficient in hacking and etc.\n\nCustodians will outperform self custody wallets in cybersecurity as custodians will have access to cutting edge AI. https://t.co/Qh5rpWWpl0",
"IS_REPLY": "false",
"IS_QUOTE": "true",
"IS_RETWEET": "false",
"QUOTED_AUTHOR_HANDLE": "glove",
"QUOTED_AUTHOR_NAME": "G. Love",
"QUOTED_AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1873855589291266049/hYka0NCi_normal.jpg",
"QUOTED_TWEET_ID": "2043047396322451700",
"QUOTED_TWEET_LINK": "https://x.com/glove/status/2043047396322451700",
"QUOTED_TWEET_TEXT": "I had a really tough day today I lost my retirement fund in a hack/Scam when I switched my @Ledger over to my new computer and by accident downloaded a malicious ledger app from the @Apple store. All my BTC gone in an instant.",
"QUOTED_AUTHOR_CREATED_AT": "Tue Feb 03 19:21:52 +0000 2009",
"QUOTED_AUTHOR_FOLLOWERS_COUNT": "65621",
"QUOTED_AUTHOR_BIO": "My New album Ode To R.L. OUT NOW!!",
"QUOTED_AUTHOR_LOCATION": "Philly, PA!",
"SOURCE_URL": "https://x.com/StrategyMaxi/status/2043389521816097190",
"CATEGORY": "CUSTOM"
},
"_id": "strategymaxi-TWITTER_DELETED-2043389521816097190",
"source": "Terminal",
"title": "🗑️ @StrategyMaxi deleted quote (posted 23m ago)",
"body": "I blame on ideological Bitcoiners preaching self custody.\n\nTime to normalize the trust in custodians...",
"icon": "https://pbs.twimg.com/profile_images/2042056285622038532/bc6m9iR6_normal.jpg",
"url": "https://x.com/StrategyMaxi/status/2043389521816097190",
"time": 1776018387143
}Messages from tracked Telegram channels. Includes channel info, message content, and detected contract addresses.
How to identify: tags.TYPE === "NEW_TELEGRAM_MESSAGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain if CA detected | "ETHEREUM" |
| CONTRACT_ADDRESS | Detected token CA | "0x548fefd928..." |
| CHANNEL_ID | Telegram channel ID | "basepairs" |
| CHANNEL_NAME | Channel display name | "Base new Pairs / Contracts" |
| CHANNEL_ICON | Channel avatar URL | "https://cdn4.telesco.pe/..." |
| MESSAGE_ID | Message ID | "696e8a6f22a5d24755424516" |
| MESSAGE_TEXT | Message content | "📜 New contract deployed!..." |
| MESSAGE_TEXT_TRANSLATED | Translation if non-English | "... [Translated]" |
| MESSAGE_IMAGE | Attached image URL | "https://..." |
| MESSAGE_LINK | Link to message | "https://t.me/BasePairs/2957755" |
| IS_FORWARD | Whether message is forwarded | "true" |
| FORWARDED_CHANNEL_ID | Original channel handle | "monitoringsituation" |
| FORWARDED_CHANNEL_NAME | Original channel name | "Monitoring The Situation" |
| FORWARDED_MESSAGE_ID | Original message ID | "4304" |
| FORWARDED_MESSAGE_LINK | Link to original message | "https://t.me/MonitoringSituation/4304" |
Example
{
"tags": {
"CHAIN": "ETHEREUM",
"CONTRACT_ADDRESS": "0x548fefd9284367c183d4a0aB2aD7e87429Ee8489",
"CHANNEL_ID": "basepairs",
"CHANNEL_NAME": "Base new Pairs / Contracts | Prodigy Bots",
"CHANNEL_ICON": "https://cdn4.telesco.pe/file/QwOXy7HXzP6DlOPbCSBd1CGxRIKcnrIOGUcr...",
"MESSAGE_ID": "696e8a6f22a5d24755424516",
"MESSAGE_TEXT": "base | 📜 New contract deployed! 📜\n🔗 Token: Shiba Spark ($SHIBASK)\n0x548fefd9284367c183d4a0aB2aD7e87429Ee8489\n🏦 Supply: 1000000 | 18 decimals",
"MESSAGE_IMAGE": null,
"MESSAGE_LINK": "https://t.me/BasePairs/2957755",
"IS_FORWARD": "false"
},
"_id": "696e8a6f22a5d24755424516",
"title": "📱 Base new Pairs / Contracts | Prodigy Bots",
"body": "base | 📜 New contract deployed!..."
}Posts from tracked Truth Social accounts (e.g., Trump). Includes author info, post content, and media.
How to identify: tags.TYPE === "TRUTH_SOCIAL" && tags.SUBTYPE === "POST"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "TRUTH_SOCIAL" |
| SUBTYPE | Event type | "POST" |
| AUTHOR_ID | Truth Social user ID | "107780257626128497" |
| AUTHOR_TWITTER_ID | Linked Twitter ID | "107780257626128497" |
| AUTHOR_USERNAME | Username | "realDonaldTrump" |
| AUTHOR_DISPLAY_NAME | Display name | "Donald J. Trump" |
| AUTHOR_ICON | Profile picture URL | "https://..." |
| POST_ID | Post ID | "115923723486523883" |
| POST_TEXT | Post content | "..." |
| POST_URL | URL to post | "https://truthsocial.com/@realDonaldTrump/..." |
| IMAGE | Attached image URL | "https://..." |
| VIDEO | Attached video URL | "https://..." |
| SOURCE_URL | URL to the post | "https://truthsocial.com/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "TRUTH_SOCIAL",
"SUBTYPE": "POST",
"AUTHOR_ID": "107780257626128497",
"AUTHOR_TWITTER_ID": "107780257626128497",
"AUTHOR_USERNAME": "realDonaldTrump",
"AUTHOR_DISPLAY_NAME": "Donald J. Trump",
"AUTHOR_ICON": "https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fstatic-assets-1.truthsocial.com%2Ftmtg%3Aprime-ts-assets%2Faccounts%2Favatars%2F107%2F780%2F257%2F626%2F128%2F497%2Foriginal%2F454286ac07a6f6e6.jpeg&f=1",
"POST_ID": "115923723486523883",
"POST_TEXT": "",
"POST_URL": "https://truthsocial.com/@realDonaldTrump/115923723486523883",
"IMAGE": "https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fstatic-assets-1.truthsocial.com%2Ftmtg%3Aprime-ts-assets%2Fmedia_attachments%2Ffiles%2F115%2F923%2F722%2F130%2F275%2F809%2Foriginal%2F1700034b49a05d98.jpg&f=1",
"SOURCE_URL": "https://truthsocial.com/@realDonaldTrump/115923723486523883"
},
"_id": "115923723486523883",
"type": "direct",
"title": "Donald J. Trump (@realDonaldTrump)",
"body": "",
"link": "https://truthsocial.com/@realDonaldTrump/115923723486523883",
"time": 1768855644024
}Posts from tracked Warpcast/Farcaster accounts. Similar structure to other social media posts.
How to identify: tags.TYPE === "WARPCAST" && tags.SUBTYPE === "POST"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "WARPCAST" |
| SUBTYPE | Event type | "POST" |
| AUTHOR_ID | Farcaster user ID | "12345" |
| AUTHOR_USERNAME | Username (lowercase) | "vitalik.eth" |
| AUTHOR_DISPLAY_NAME | Display name | "Vitalik Buterin" |
| AUTHOR_ICON | Profile picture URL | "https://..." |
| CAST_ID | Cast hash ID | "0x..." |
| CAST_TEXT | Cast content | "..." |
| POST_URL | URL to post | "https://warpcast.com/..." |
| IS_REPLY | Is this a reply to another cast | "true" / "false" |
| IMAGE / IMAGE2 / IMAGE3 / IMAGE4 | Attached image URLs | "https://..." |
| VIDEO / VIDEO2 / VIDEO3 / VIDEO4 | Attached video URLs | "https://..." |
| CONTRACT_ADDRESS | CA if detected | "pump..." |
| CHAIN | Blockchain if CA detected | "SOL" |
Example
{
"tags": {
"TYPE": "WARPCAST",
"SUBTYPE": "POST",
"AUTHOR_USERNAME": "vitalik.eth",
"AUTHOR_DISPLAY_NAME": "Vitalik Buterin",
"POST_ID": "0xabc123",
"POST_TEXT": "Interesting thoughts on...",
"POST_URL": "https://warpcast.com/vitalik.eth/0xabc123"
},
"_id": "warpcast-0xabc123",
"title": "Vitalik Buterin (@vitalik.eth)",
"body": "Interesting thoughts on..."
}Token swap transactions from tracked wallets. Includes trade direction, amounts, token info, and market data.
How to identify: tags.TYPE === "WALLET_SWAP"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "BASE" / "SOL" |
| CONTRACT_ADDRESS | Swapped token address | "0x7df3fd4e53..." |
| WALLET_ADDRESS | Wallet address | "0x5b0051e4ea..." |
| WALLET_LABEL | Wallet label if set | "b2" |
| WALLET_URL | Block explorer URL | "https://basescan.org/address/..." |
| TRANSACTION_ACTION | BUY or SELL | "BUY" |
| TRANSACTION_TYPE | Transaction type | "SWAP" |
| TRANSACTION_PLATFORM | DEX/platform used | "RAYDIUM" / "PUMP_FUN" |
| TRANSACTION_ID | Transaction hash | "0x83196361e82b..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768852449" |
| FROM_TOKEN_TICKER | Token sold symbol | "WETH" |
| FROM_TOKEN_AMOUNT | Amount sold | "0.25" |
| TO_TOKEN_TICKER | Token bought symbol | "SMILE" |
| TO_TOKEN_AMOUNT | Amount bought | "7497.501388487983" |
| BASE_TOKEN_TICKER | Base currency | "WETH" |
| BASE_TOKEN_AMOUNT_USD | USD value of trade | "820.315" |
| SWAPPED_TOKEN_ADDRESS | Token contract address | "0x7df3fd4e53..." |
| SWAPPED_TOKEN_TICKER | Token symbol | "SMILE" |
| SWAPPED_TOKEN_NAME | Token name | "SMILE" |
| SWAPPED_TOKEN_AMOUNT | Amount swapped | "7497.501388487983" |
| SWAPPED_TOKEN_IMAGE_URL | Token image | "https://logos.uniwhales.io/..." |
| SWAPPED_TOKEN_MARKET_CAP_USD | Market cap | "5000000" |
| SWAPPED_TOKEN_SUPPLY_PERCENTAGE | % of supply traded | "0.5" |
| SWAPPED_TOKEN_BALANCE | Post-trade balance | "1000000" |
| SWAPPED_TOKEN_BALANCE_USD | Balance in USD | "150.00" |
| SWAPPED_TOKEN_BALANCE_SUPPLY_PERCENTAGE | Balance % of supply | "0.1" |
| FIRST_INTERACTION | First time wallet interacted with token | "true" / "false" |
| TRANSACTION_URL | Block explorer URL for transaction | "https://solscan.io/tx/..." |
| PREFERRED_TRADING_URL | Best trading URL | "https://gmgn.ai/..." |
| PHOTON_URL | Photon trading URL | "https://photon-base.tinyastro.io/..." |
| FOMO_URL | FOMO trading URL | "https://fomo.family/tokens/base/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"CHAIN": "BASE",
"CONTRACT_ADDRESS": "0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"WALLET_ADDRESS": "0x5b0051e4ea8eaf6ec523ab2aa76fe0149e68b040",
"WALLET_LABEL": "b2",
"WALLET_URL": "https://basescan.org/address/0x5b0051e4ea8eaf6ec523ab2aa76fe0149e68b040",
"TRANSACTION_ACTION": "BUY",
"TRANSACTION_TYPE": "SWAP",
"TRANSACTION_PLATFORM": "SIGMAWIN",
"TRANSACTION_ID": "0x83196361e82b0658da088dd240d9a6e54e1816d556a922f3baa1cf8544cf28df",
"TRANSACTION_TIMESTAMP": "1768852449",
"FROM_TOKEN_TICKER": "WETH",
"FROM_TOKEN_AMOUNT": "0.25",
"TO_TOKEN_TICKER": "SMILE",
"TO_TOKEN_AMOUNT": "7497.501388487983",
"BASE_TOKEN_TICKER": "WETH",
"BASE_TOKEN_AMOUNT_USD": "820.315",
"SWAPPED_TOKEN_ADDRESS": "0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"SWAPPED_TOKEN_TICKER": "SMILE",
"SWAPPED_TOKEN_NAME": "SMILE",
"SWAPPED_TOKEN_AMOUNT": "7497.501388487983",
"SWAPPED_TOKEN_IMAGE_URL": "https://logos.uniwhales.io/base/0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a.jpg",
"PREFERRED_TRADING_URL": "https://gmgn.ai/base/token/bark_0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"PHOTON_URL": "https://photon-base.tinyastro.io/en/r/@risitas/0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a"
},
"_id": "0x831-WALLET_SWAP",
"source": "Terminal",
"title": "🟢[b2] swapped 0.25 WETH to 7498 SMILE",
"body": "\n📈 TRADE: https://gmgn.ai/base/token/bark_0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"url": "https://gmgn.ai/base/token/bark_0x7df3fd4e53776a9eacca3d6e79c5f0a899ea371a",
"time": 1768852450751
}Token transfer received by a tracked wallet. Includes sender/receiver info and token details.
How to identify: tags.TYPE === "TOKEN_RECEIVED"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| CONTRACT_ADDRESS | Token address | "8vzmc7He4DDxzU..." |
| WALLET_ADDRESS | Receiver wallet | "42cfcPtPRHN6YQ..." |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| TRANSACTION_TYPE | Transaction type | "TOKEN_RECEIVED" |
| TRANSACTION_ID | Transaction hash | "2JmVD2GGr9Mzkd..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| TOKEN_ADDRESS | Token contract | "8vzmc7He4DDxzU..." |
| TOKEN_TICKER | Token symbol | "SPS" |
| TOKEN_NAME | Token name | "Solid Poops Season" |
| TOKEN_IMAGE_URL | Token image | "https://ipfs.io/ipfs/..." |
| TOKEN_AMOUNT | Amount transferred | "1.0E7" |
| TOKEN_AMOUNT_USD | USD value | "0.0" |
| TOKEN_BALANCE | Balance after | "1.0E7" |
| TOKEN_BALANCE_USD | Balance USD value | "0.0" |
| TOKEN_PRICE_USD | Token price | "0.0" |
| TOKEN_SUPPLY | Total supply | "1.0E9" |
| TOKEN_SUPPLY_PERCENTAGE | % of supply transferred | "1.0" |
| TOKEN_BALANCE_SUPPLY_PERCENTAGE | Balance % of supply | "1.0" |
| TOKEN_MARKET_CAP_USD | Market cap | "0.0" |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| SENDER_ADDRESS | Sender wallet | "H5jbQTiL2FVxPi..." |
| SENDER_LABEL | Label for sender wallet if set | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "1.0881978609146E7" |
| RECEIVER_ADDRESS | Receiver wallet | "42cfcPtPRHN6YQ..." |
| RECEIVER_LABEL | Receiver label if set | "BonkFun Dev" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "1.0E7" |
| COUNTERPARTY_ADDRESS | Other party address | "H5jbQTiL2FVxPi..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| PREFERRED_TRADING_URL | Best trading URL | "https://trade.padre.gg/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"CHAIN": "SOL",
"CONTRACT_ADDRESS": "8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk",
"WALLET_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"WALLET_URL": "https://solscan.io/address/42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"TRANSACTION_TYPE": "TOKEN_RECEIVED",
"TRANSACTION_ID": "2JmVD2GGr9Mzkd9yoANKpChCnCZe7bKTBHFA2xuLjjizBY3FHugaAw16Tt2DTY7R1zvxz4HvcVpSckCwnG9otMKE",
"TRANSACTION_TIMESTAMP": "1768856761",
"TOKEN_ADDRESS": "8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk",
"TOKEN_TICKER": "SPS",
"TOKEN_NAME": "Solid Poops Season",
"TOKEN_IMAGE_URL": "https://ipfs.io/ipfs/bafybeihfq5qiqxql2mrj4b2ikulos5cza52di3gbgqloidshvt53shzibe",
"TOKEN_AMOUNT": "1.0E7",
"TOKEN_BALANCE": "1.0E7",
"SENDER_ADDRESS": "H5jbQTiL2FVxPihbsds3H5FBDCdm84sXP5on6p5VWNvU",
"RECEIVER_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"RECEIVER_LABEL": "BonkFun Dev",
"COUNTERPARTY_ADDRESS": "H5jbQTiL2FVxPihbsds3H5FBDCdm84sXP5on6p5VWNvU",
"PREFERRED_TRADING_URL": "https://trade.padre.gg/trade/solana/8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk?rk=bark",
"SOURCE_URL": "https://solscan.io/tx/2JmVD2GGr9Mzkd9yoANKpChCnCZe7bKTBHFA2xuLjjizBY3FHugaAw16Tt2DTY7R1zvxz4HvcVpSckCwnG9otMKE"
},
"_id": "2JmVD-TOKEN_RECEIVED",
"type": "TOKEN_RECEIVED",
"source": "Terminal",
"title": "📥 [BonkFun Dev] received 10000000 SPS from [H5jbQT...5VWNvU]",
"body": "8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk\n----------\n📈 TRADE: https://trade.padre.gg/trade/solana/8vzmc7He4DDxzUFC4srV4MDPPjkvomm3EuGpq4QJbonk?rk=bark",
"url": "https://solscan.io/address/42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"time": 1768856761456
}Token transfer sent from a tracked wallet. Same structure as Token Received.
How to identify: tags.TYPE === "TOKEN_SENT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| CONTRACT_ADDRESS | Token address | "8vzmc7He4DDxzU..." |
| WALLET_ADDRESS | Sender wallet | "42cfcPtPRHN6YQ..." |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| TRANSACTION_TYPE | Transaction type | "TOKEN_SENT" |
| TRANSACTION_ID | Transaction hash | "2JmVD2GGr9Mzkd..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| TOKEN_ADDRESS | Token contract | "8vzmc7He4DDxzU..." |
| TOKEN_TICKER | Token symbol | "SPS" |
| TOKEN_NAME | Token name | "Solid Poops Season" |
| TOKEN_IMAGE_URL | Token image | "https://ipfs.io/ipfs/..." |
| TOKEN_AMOUNT | Amount transferred | "1.0E7" |
| TOKEN_AMOUNT_USD | USD value | "0.0" |
| TOKEN_PRICE_USD | Token price | "0.0" |
| TOKEN_BALANCE | Balance after | "1.0E7" |
| TOKEN_BALANCE_USD | Balance USD value | "0.0" |
| TOKEN_SUPPLY | Total supply | "1.0E9" |
| TOKEN_SUPPLY_PERCENTAGE | % of supply transferred | "1.0" |
| TOKEN_BALANCE_SUPPLY_PERCENTAGE | Balance % of supply | "1.0" |
| TOKEN_MARKET_CAP_USD | Market cap | "0.0" |
| SENDER_ADDRESS | Sender wallet | "42cfcPtPRHN6YQ..." |
| SENDER_LABEL | Label for sender wallet if set | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "0" |
| SENDER_BALANCE_AFTER_USD | Sender balance USD | "0.0" |
| SENDER_BALANCE_SUPPLY_PERCENTAGE | Sender balance % of supply | "0.0" |
| RECEIVER_ADDRESS | Receiver wallet | "H5jbQTiL2FVxPi..." |
| RECEIVER_LABEL | Receiver label if set | "BonkFun Dev" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "1.0E7" |
| RECEIVER_BALANCE_AFTER_USD | Receiver balance USD | "0.0" |
| RECEIVER_BALANCE_SUPPLY_PERCENTAGE | Receiver balance % of supply | "1.0" |
| COUNTERPARTY_ADDRESS | Other party address | "H5jbQTiL2FVxPi..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| PREFERRED_TRADING_URL | Best trading URL | "https://trade.padre.gg/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"tags": {
"CHAIN": "SOL",
"TRANSACTION_TYPE": "TOKEN_SENT",
"TOKEN_TICKER": "PEPE",
"TOKEN_AMOUNT": "1000000",
"SENDER_ADDRESS": "your_wallet_address",
"RECEIVER_ADDRESS": "recipient_wallet_address"
},
"_id": "abc123-TOKEN_SENT",
"title": "📤 [Your Wallet] sent 1000000 PEPE to [Recipient]"
}Native SOL transfer received by a tracked wallet. Simpler structure than token transfers.
How to identify: tags.TYPE === "SOL_RECEIVED"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Always SOL | "SOL" |
| TRANSACTION_TYPE | Transaction type | "SOL_RECEIVED" |
| TRANSACTION_ID | Transaction hash | "abc..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| WALLET_ADDRESS | Receiver wallet | "abc..." |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| SOL_AMOUNT | Amount in SOL | "1.5" |
| WALLET_BALANCE_AFTER | Balance after transfer | "10.5" |
| SENDER_ADDRESS | Sender wallet | "xyz..." |
| SENDER_LABEL | Label for sender wallet | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "10.5" |
| RECEIVER_ADDRESS | Receiver wallet | "abc..." |
| RECEIVER_LABEL | Label for receiver wallet | "CEX Deposit" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "5.0" |
| COUNTERPARTY_ADDRESS | Other party address | "xyz..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"tags": {
"CHAIN": "SOL",
"TRANSACTION_TYPE": "SOL_RECEIVED",
"WALLET_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"SOL_AMOUNT": "1.5",
"SENDER_ADDRESS": "H5jbQTiL2FVxPihbsds3H5FBDCdm84sXP5on6p5VWNvU",
"RECEIVER_ADDRESS": "42cfcPtPRHN6YQkWMzFhD9N67XWNZnAARYdMoR7RjsLX",
"TRANSACTION_ID": "abc123..."
},
"_id": "abc123-SOL_RECEIVED",
"title": "📥 Received 1.5 SOL"
}Native SOL transfer sent from a tracked wallet. Same structure as SOL Received.
How to identify: tags.TYPE === "SOL_SENT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Always SOL | "SOL" |
| TRANSACTION_TYPE | Transaction type | "SOL_SENT" |
| TRANSACTION_ID | Transaction hash | "abc..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768856761" |
| WALLET_ADDRESS | Sender wallet | "abc..." |
| WALLET_LABEL | Label for tracked wallet | "Alpha Whale" |
| WALLET_URL | Block explorer URL | "https://solscan.io/address/..." |
| SOL_AMOUNT | Amount in SOL | "1.5" |
| WALLET_BALANCE_AFTER | Balance after transfer | "10.5" |
| SENDER_ADDRESS | Sender wallet | "abc..." |
| SENDER_LABEL | Label for sender wallet | "Dev Wallet" |
| SENDER_BALANCE_AFTER | Sender balance after | "10.5" |
| RECEIVER_ADDRESS | Receiver wallet | "xyz..." |
| RECEIVER_LABEL | Label for receiver wallet | "CEX Deposit" |
| RECEIVER_BALANCE_AFTER | Receiver balance after | "5.0" |
| COUNTERPARTY_ADDRESS | Other party address | "xyz..." |
| COUNTERPARTY_URL | Other party explorer URL | "https://solscan.io/address/..." |
| SOURCE_URL | Transaction explorer URL | "https://solscan.io/tx/..." |
Example
{
"tags": {
"CHAIN": "SOL",
"TRANSACTION_TYPE": "SOL_SENT",
"SOL_AMOUNT": "1.5"
},
"_id": "abc123-SOL_SENT",
"title": "📤 Sent 1.5 SOL"
}Perpetual futures position changes from tracked wallets. Includes position type (LONG/SHORT), action (OPEN/CLOSE/ADD/REDUCE), and size info.
How to identify: tags.TYPE === "PERP_POSITION"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain/platform | "HYPERLIQUID" |
| WALLET_ADDRESS | Trader wallet | "0x8f8b4759dc93..." |
| WALLET_LABEL | Wallet label if set | "Mister Todd" |
| TRANSACTION_ACTION | BUY or SELL | "BUY" |
| TRANSACTION_PLATFORM | Exchange platform | "HYPERLIQUID" |
| TRANSACTION_ID | Transaction hash | "0x5903d6548ff2..." |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1768852121" |
| TOKEN_TICKER | Asset being traded | "SOL" |
| TOKEN_AMOUNT | Position size change | "15.030000000000001" |
| TOKEN_AMOUNT_USD | USD value of change | "2020.6332000000002" |
| AVERAGE_PRICE | Entry/exit price | "134.44" |
| POSITION_ACTION | OPEN/CLOSE/ADD/REDUCE | "OPEN" |
| POSITION_TYPE | LONG or SHORT | "LONG" |
| POSITION_CHANGE_PERCENT | % change in position | "Infinity" (new position) |
| OLD_POSITION_SIZE | Size before | "0.0" |
| OLD_POSITION_SIZE_USD | USD value before | "0.0" |
| NEW_POSITION_SIZE | Size after | "15.030000000000001" |
| NEW_POSITION_SIZE_USD | USD value after | "2020.6332000000002" |
| IS_LIQUIDATION | Was position liquidated | "true" / "false" |
Example
{
"tags": {
"CHAIN": "HYPERLIQUID",
"WALLET_ADDRESS": "0x8f8b4759dc93ca55bd6997df719f20f581f10f5c",
"WALLET_LABEL": "Mister Todd",
"TRANSACTION_ACTION": "BUY",
"TRANSACTION_PLATFORM": "HYPERLIQUID",
"TRANSACTION_ID": "0x5903d6548ff29b33d43e7a4050d0483b968aa953c910996889540d45b5984c57aggr",
"TRANSACTION_TIMESTAMP": "1768852121",
"TOKEN_TICKER": "SOL",
"TOKEN_AMOUNT": "15.030000000000001",
"TOKEN_AMOUNT_USD": "2020.6332000000002",
"AVERAGE_PRICE": "134.44",
"POSITION_ACTION": "OPEN",
"POSITION_TYPE": "LONG",
"POSITION_CHANGE_PERCENT": "Infinity",
"OLD_POSITION_SIZE": "0.0",
"OLD_POSITION_SIZE_USD": "0.0",
"NEW_POSITION_SIZE": "15.030000000000001",
"NEW_POSITION_SIZE_USD": "2020.6332000000002",
"IS_LIQUIDATION": "false"
},
"_id": "0x5903-PERP_POSITION",
"title": "📈 [Mister Todd] OPENED LONG 15.03 SOL @ $134.44",
"body": "Position size: $2,020.63"
}A resting limit order placed or cancelled on a Hyperliquid perp. This is intent, not a trade — nothing has filled and nothing may ever fill. Only orders that actually rest on the book are sent: a marketable order goes straight to a fill and arrives as PERP_POSITION instead, and the TP/SL pair Hyperliquid auto-attaches to a position is excluded. A burst of orders on the same market side is merged into one event carrying ORDERS_IN_WINDOW and a price range.
How to identify: tags.TYPE === "PERP_ORDER"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain/platform | "HYPERLIQUID" |
| WALLET_ADDRESS | Trader wallet | "0xeb6eda4756f8..." |
| WALLET_LABEL | Wallet label if set | "Hyper Whale" |
| ORDER_ACTION | PLACED or CANCELLED | "PLACED" |
| ORDER_STATUS | Raw Hyperliquid status | "open" / "canceled" |
| ORDER_ID | Hyperliquid order id (oid) | "258166303284" |
| CLIENT_ORDER_ID | Client order id if set (cloid) | "0x89119db7aae1..." |
| ORDER_TYPE | Order kind | "Limit" |
| TIME_IN_FORCE | Gtc / Ioc / Alo | "Gtc" |
| TRANSACTION_ACTION | BUY (bid) or SELL (ask) | "BUY" |
| POSITION_TYPE | Side of the book this order would leave the wallet on | "LONG" |
| TOKEN_TICKER | Perp market | "ZEC" |
| TOKEN_AMOUNT | Order size | "1000.0" |
| TOKEN_AMOUNT_USD | Notional (size x limit price) | "356420.0" |
| LIMIT_PRICE | Resting price | "356.42" |
| AVERAGE_PRICE | Same as LIMIT_PRICE, for renderers that only know the position vocabulary | "356.42" |
| MARK_PRICE | Mark price at publish time. Absent when unavailable | "400.0" |
| DISTANCE_FROM_MARK_PERCENT | Signed; negative means below the mark | "-10.895" |
| REDUCE_ONLY | Order can only close an existing position | "true" / "false" |
| IS_TRIGGER | Standalone stop/take-profit order | "true" / "false" |
| TRIGGER_PRICE | Trigger level. Only when IS_TRIGGER | "300.0" |
| TRIGGER_CONDITION | Trigger condition. Only when IS_TRIGGER | "N/A" |
| ORDERS_IN_WINDOW | Orders merged into this event. Absent when it was a single order | "12" |
| ORDER_PRICE_MIN | Cheapest rung of a merged ladder | "350.0" |
| ORDER_PRICE_MAX | Dearest rung of a merged ladder | "360.0" |
| TRANSACTION_TIMESTAMP | Unix timestamp in SECONDS | "1764867600" |
Example
{
"tags": {
"CHAIN": "HYPERLIQUID",
"WALLET_ADDRESS": "0xeb6eda4756f831824cd28e568ef8adcff35016e3",
"WALLET_LABEL": "Hyper Whale",
"ORDER_ACTION": "PLACED",
"ORDER_STATUS": "open",
"ORDER_ID": "258166303284",
"ORDER_TYPE": "Limit",
"TIME_IN_FORCE": "Gtc",
"TRANSACTION_ACTION": "BUY",
"POSITION_TYPE": "LONG",
"TOKEN_TICKER": "ZEC",
"TOKEN_AMOUNT": "1000.0",
"TOKEN_AMOUNT_USD": "356420.0",
"LIMIT_PRICE": "356.42",
"MARK_PRICE": "400.0",
"DISTANCE_FROM_MARK_PERCENT": "-10.895",
"REDUCE_ONLY": "false",
"IS_TRIGGER": "false",
"TRANSACTION_TIMESTAMP": "1764867600"
},
"_id": "258166303284-open-PERP_ORDER",
"title": "🟢[Hyper Whale] placed a $356.4k bid on ZEC @ $356.42 (11% below mark)"
}A TWAP schedule started or stopped on a Hyperliquid perp. A TWAP is one decision the exchange then executes as a long series of small fills; those fills are suppressed, so these two events are the only trace of it. TOKEN_AMOUNT_USD is quoted at the mark price while the schedule is still running and is what actually traded once it has stopped.
How to identify: tags.TYPE === "PERP_TWAP"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain/platform | "HYPERLIQUID" |
| WALLET_ADDRESS | Trader wallet | "0x8def9f50456c..." |
| WALLET_LABEL | Wallet label if set | "Hyper Whale" |
| TWAP_ACTION | STARTED, FINISHED or TERMINATED (cancelled early) | "STARTED" |
| TWAP_STATUS | Raw Hyperliquid status | "activated" |
| TWAP_ID | Hyperliquid TWAP id | "1430699" |
| TWAP_DURATION_MINUTES | Scheduled duration | "90" |
| TWAP_RANDOMIZE | Randomised slice timing | "true" / "false" |
| TWAP_PROGRESS_PERCENT | Share of the schedule filled | "30.0" |
| TRANSACTION_ACTION | BUY or SELL | "BUY" |
| POSITION_TYPE | LONG or SHORT | "LONG" |
| TOKEN_TICKER | Perp market | "HYPE" |
| TOKEN_AMOUNT | Total scheduled size | "50000.0" |
| TOKEN_AMOUNT_EXECUTED | Size filled so far | "0.0" |
| TOKEN_AMOUNT_USD | Value: mark-quoted while running, executed once stopped | "2000000.0" |
| TOKEN_AMOUNT_EXECUTED_USD | Exact executed notional. Only once something has filled | "1900000.0" |
| AVERAGE_PRICE | Achieved average once filled, else the mark | "38.0" |
| MARK_PRICE | Mark price at publish time. Absent when unavailable | "40.0" |
| REDUCE_ONLY | Schedule can only close an existing position | "true" / "false" |
| TRANSACTION_TIMESTAMP | Unix timestamp in SECONDS | "1764867622" |
Example
{
"tags": {
"CHAIN": "HYPERLIQUID",
"WALLET_ADDRESS": "0x8def9f50456c6c4e37fa5d3d57f108ed23992dae",
"WALLET_LABEL": "Hyper Whale",
"TWAP_ACTION": "STARTED",
"TWAP_STATUS": "activated",
"TWAP_ID": "1430699",
"TWAP_DURATION_MINUTES": "90",
"TWAP_RANDOMIZE": "true",
"TWAP_PROGRESS_PERCENT": "0.0",
"TRANSACTION_ACTION": "BUY",
"POSITION_TYPE": "LONG",
"TOKEN_TICKER": "HYPE",
"TOKEN_AMOUNT": "50000.0",
"TOKEN_AMOUNT_EXECUTED": "0.0",
"TOKEN_AMOUNT_USD": "2000000.0",
"MARK_PRICE": "40.0",
"REDUCE_ONLY": "false",
"TRANSACTION_TIMESTAMP": "1764867622"
},
"_id": "1430699-activated-PERP_TWAP",
"title": "🟢[Hyper Whale] started a $2M HYPE long TWAP over 1h 30m"
}Triggered when multiple tracked wallets buy the same token within a short time window. Useful for detecting coordinated buys or trending tokens.
How to identify: tags.TYPE === "AGGREGATED_BUY"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| CONTRACT_ADDRESS | Token address | "Trove4jcQhE1dZ..." |
| WALLET_COUNT | Number of wallets that bought | "10" |
| THRESHOLD | Minimum wallet threshold | "10" |
| MINUTES | Time window in minutes | "2" |
| TOTAL_BUY_AMOUNT_USD | Total USD value bought | "38323.34473281339" |
| TOKEN_TICKER | Token symbol | "TROVE" |
| TOKEN_NAME | Token name | "TROVE" |
| TOKEN_MARKET_CAP_USD | Current market cap | "8876599.037534805" |
| TOKEN_IMAGE_URL | Token image URL | "https://gateway.irys.xyz/..." |
| TOKEN_TWITTER | Token's Twitter handle | "@newtoken" |
| TOKEN_TELEGRAM | Token's Telegram link | "https://t.me/newtoken" |
| TOKEN_WEBSITE | Token's website URL | "https://newtoken.xyz" |
| BULLX_URL | BullX trading URL | "https://bullx.io/terminal?..." |
| AXIOM_URL | Axiom trading URL | "https://axiom.trade/t/..." |
| PHOTON_URL | Photon trading URL | "https://photon-sol.tinyastro.io/..." |
| FOMO_URL | FOMO trading URL | "https://fomo.family/tokens/solana/..." |
| SOURCE_URL | Token explorer URL | "https://solscan.io/token/..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"CHAIN": "SOL",
"CONTRACT_ADDRESS": "Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ",
"WALLET_COUNT": "10",
"THRESHOLD": "10",
"MINUTES": "2",
"TOTAL_BUY_AMOUNT_USD": "38323.34473281339",
"TOKEN_TICKER": "TROVE",
"TOKEN_NAME": "TROVE",
"TOKEN_MARKET_CAP_USD": "8876599.037534805",
"TOKEN_IMAGE_URL": "https://gateway.irys.xyz/3Yh5ZMsyKx5FDCw1crJfFdnrwKBEU2MTZ3fMFem44Awt",
"BULLX_URL": "https://bullx.io/terminal?chainId=1399811149&address=Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ&r=ZCMO2CXX4JA",
"AXIOM_URL": "https://axiom.trade/t/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ/@risi?chain=sol",
"PHOTON_URL": "https://photon-sol.tinyastro.io/en/r/@risitas/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ",
"SOURCE_URL": "https://solscan.io/token/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ"
},
"_id": "9c8d0-AGGREGATED_BUY",
"source": "Terminal",
"title": "🟢 10 wallets bought $38k of TROVE in the last 2 minutes. Current market cap: $8.9M",
"body": "Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ\n----------",
"url": "https://solscan.io/token/Trove4jcQhE1dZGrjBwe8LUEAZizcFDZ35gUHezmjhZ",
"time": 1768853008938
}AI-filtered news articles from tracked sources. Includes keyword matching and AI-generated summaries.
How to identify: tags.TYPE === "NEWS_ARTICLE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEWS_ARTICLE" |
| MATCHED_KEYWORD | Keyword that triggered match | "bitcoin" |
| SUMMARY | AI-generated summary | "Bitcoin reaches new ATH..." |
| NAMES | Comma-separated names extracted | "Bitcoin, BTC" |
Example
{
"tags": {
"TYPE": "NEWS_ARTICLE",
"MATCHED_KEYWORD": "bitcoin etf",
"SUMMARY": "SEC approves first spot Bitcoin ETF, marking a historic moment for cryptocurrency adoption.",
"NAMES": "Bitcoin, SEC, BlackRock"
},
"_id": "news-article-123456",
"source": "Terminal",
"title": "SEC Approves Spot Bitcoin ETF",
"body": "In a landmark decision, the Securities and Exchange Commission...",
"url": "https://example.com/news/bitcoin-etf",
"time": 1768853008938
}Posts from tracked Binance Square users. Includes author info and post content.
How to identify: tags.TYPE === "BINANCE_SQUARE_POST"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "BINANCE_SQUARE_POST" |
| ARTICLE_ID | Post identifier | "123456789" |
| USERNAME | Poster username | "cz_binance" |
| DISPLAY_NAME | Display name | "CZ" |
| TITLE | Post title (optional) | "Market Update" |
| CONTENT | Post content | "The market is looking strong..." |
| IMAGE_URL | Cover image URL (optional) | "https://..." |
| AVATAR | Poster avatar URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "BINANCE_SQUARE_POST",
"ARTICLE_ID": "123456789012345678",
"USERNAME": "cz_binance",
"DISPLAY_NAME": "CZ",
"TITLE": "Market Thoughts",
"CONTENT": "Here's my take on the current market conditions...",
"IMAGE_URL": "https://public.bnbstatic.com/image/...",
"AVATAR": "https://public.bnbstatic.com/avatar/..."
},
"_id": "binance-square-123456789",
"source": "Terminal",
"title": "CZ (@cz_binance) - Market Thoughts",
"body": "Here's my take on the current market conditions...",
"time": 1768853008938
}New token listings on Binance Alpha. Includes token info and market data.
How to identify: tags.TYPE === "BINANCE_ALPHA_LISTING"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "BINANCE_ALPHA_LISTING" |
| CONTRACT_ADDRESS | Token contract address | "0x..." |
| CHAIN | Blockchain | "BASE" / "SOL" / "BNB" |
| NAME | Token name | "Pepe Token" |
| SYMBOL | Token symbol | "PEPE" |
| MARKET_CAP_USD | Market cap in USD | "5000000" |
| ICON | Token icon URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "BINANCE_ALPHA_LISTING",
"CONTRACT_ADDRESS": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"CHAIN": "ETHEREUM",
"NAME": "Pepe",
"SYMBOL": "PEPE",
"MARKET_CAP_USD": "5000000000",
"ICON": "https://assets.coingecko.com/coins/images/29850/large/pepe.png"
},
"_id": "binance-alpha-pepe",
"source": "Terminal",
"title": "New Binance Alpha Listing: PEPE",
"body": "Pepe ($PEPE) has been listed on Binance Alpha",
"time": 1768853008938
}New token listings on Moonshot platform.
How to identify: tags.TYPE === "MOONSHOT_LISTING"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "MOONSHOT_LISTING" |
| TOKEN_TICKER | Token symbol | "MOON" |
| CONTRACT_ADDRESS | Token contract address | "abc123..." |
| TOKEN_NAME | Token name | "Moonshot Token" |
| CHAIN | Blockchain | "SOL" / "ETH" |
Example
{
"tags": {
"TYPE": "MOONSHOT_LISTING",
"TOKEN_TICKER": "MOON",
"CONTRACT_ADDRESS": "MoonGHVU5Gy3c8yqEuHCmAUYtJtXWgr35uDYfk9pump",
"TOKEN_NAME": "Moonshot Token",
"CHAIN": "SOL"
},
"_id": "moonshot-listing-moon",
"source": "Terminal",
"title": "New Moonshot Listing: MOON",
"body": "Moonshot Token ($MOON) is now live on Moonshot",
"time": 1768853008938
}Token deployment transactions from tracked wallets. Includes deployer info, token metadata, and social links.
How to identify: tags.TRANSACTION_TYPE === "DEPLOY"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| CHAIN | Blockchain | "SOL" |
| WALLET_ADDRESS | Deployer wallet address | "abc123..." |
| WALLET_LABEL | Wallet label if set | "Dev Wallet" |
| TOKEN_ADDRESS | Token contract address | "pump..." |
| CONTRACT_ADDRESS | Token contract address | "pump..." |
| TOKEN_TICKER | Token symbol | "NEWTOKEN" |
| TOKEN_NAME | Token name | "New Token" |
| TOKEN_SUPPLY | Total supply | "1000000000" |
| TOKEN_IMAGE_URL | Token image URL | "https://..." |
| TOKEN_DESCRIPTION | Token description (optional) | "A revolutionary new token..." |
| TOKEN_TWITTER | Twitter handle (optional) | "@newtoken" |
| TOKEN_TELEGRAM | Telegram link (optional) | "https://t.me/newtoken" |
| TOKEN_WEBSITE | Website URL (optional) | "https://newtoken.xyz" |
| SOL_AMOUNT | SOL used in deployment | "0.5" |
| SOL_VALUE_USD | USD value of SOL spent | "75.00" |
| SUPPLY_PERCENTAGE | Percentage of supply bought during deploy | "1.5" |
| TRANSACTION_TYPE | Transaction type | "DEPLOY" |
| TRANSACTION_PLATFORM | Platform used | "PUMP_FUN" |
| TRANSACTION_TIMESTAMP | Unix timestamp | "1705123456" |
Example
{
"tags": {
"CHAIN": "SOL",
"WALLET_ADDRESS": "5xYkCBkquKJ3YAFtQGJtpGLW7jSYBBpH4kYVezQpump",
"WALLET_LABEL": "Known Dev",
"TOKEN_ADDRESS": "NewTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CONTRACT_ADDRESS": "NewTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"TOKEN_TICKER": "NEWTKN",
"TOKEN_NAME": "New Token",
"TOKEN_SUPPLY": "1000000000",
"TOKEN_IMAGE_URL": "https://ipfs.io/ipfs/bafybeihfq...",
"TOKEN_DESCRIPTION": "The next generation meme token",
"TOKEN_TWITTER": "@newtoken",
"TOKEN_TELEGRAM": "https://t.me/newtoken",
"TOKEN_WEBSITE": "https://newtoken.xyz",
"SOL_AMOUNT": "0.02",
"SOL_VALUE_USD": "3.00",
"TRANSACTION_TYPE": "DEPLOY",
"TRANSACTION_PLATFORM": "PUMP_FUN",
"TRANSACTION_TIMESTAMP": "1768853008"
},
"_id": "deploy-newtkn-123",
"source": "Terminal",
"title": "🚀 [Known Dev] deployed NEWTKN",
"body": "New Token ($NEWTKN)\n0.02 SOL ($3.00)",
"time": 1768853008938
}Trending or highlighted tokens on pump.fun. Features tokens gaining traction.
How to identify: tags.TYPE === "PUMPFUN_HIGHLIGHT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_HIGHLIGHT" |
| CONTRACT_ADDRESS | Token contract (mint) | "pump..." |
| CHAIN | Blockchain | "SOL" |
| PUMPFUN_URL | Pump.fun coin URL | "https://pump.fun/coin/..." |
| SYMBOL | Token symbol | "TREND" |
| NAME | Token name | "Trending Token" |
| USD_MARKET_CAP | Market cap in USD | "1000000" |
| HIGHLIGHT_TITLE | Highlight description (optional) | "Top Gainer" |
| IMAGE | Token image URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_HIGHLIGHT",
"CONTRACT_ADDRESS": "TrendTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"CHAIN": "SOL",
"PUMPFUN_URL": "https://pump.fun/coin/TrendTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"SYMBOL": "TREND",
"NAME": "Trending Token",
"USD_MARKET_CAP": "1500000",
"HIGHLIGHT_TITLE": "Top Gainer 24h",
"IMAGE": "https://ipfs.io/ipfs/bafybeihfq..."
},
"_id": "pumpfun-highlight-trend",
"source": "Terminal",
"title": "⭐ Pump.fun Highlight: TREND",
"body": "Top Gainer 24h - Trending Token ($TREND)\nMarket Cap: $1.5M",
"url": "https://pump.fun/coin/TrendTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"time": 1768853008938
}Callouts from tracked pump.fun users. Shows price at callout and subsequent performance.
How to identify: tags.TYPE === "PUMPFUN_CALLOUT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_CALLOUT" |
| CONTRACT_ADDRESS | Token contract (mint) | "pump..." |
| CHAIN | Blockchain | "SOL" |
| MARKET_CAP_USD | Current market cap | "500000" |
| PUMPFUN_URL | Pump.fun coin URL | "https://pump.fun/coin/..." |
| CALLOUT_USER | User making the callout | "user123" |
| CALLOUT_PRICE | Price at time of callout | "0.0001" |
| CALLOUT_MULTIPLE | Multiple since callout | "5.2" |
| CALLOUT_MAX_PRICE_SOL | Max price reached in SOL | "0.0005" |
| SYMBOL | Token symbol (optional) | "CALL" |
| NAME | Token name (optional) | "Called Token" |
| IMAGE | Token image (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_CALLOUT",
"CONTRACT_ADDRESS": "CallTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CHAIN": "SOL",
"MARKET_CAP_USD": "750000",
"PUMPFUN_URL": "https://pump.fun/coin/CallTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CALLOUT_USER": "pumpfun_alpha",
"CALLOUT_PRICE": "0.00005",
"CALLOUT_MULTIPLE": "3.5",
"CALLOUT_MAX_PRICE_SOL": "0.000175",
"SYMBOL": "CALL",
"NAME": "Called Token"
},
"_id": "pumpfun-callout-call",
"source": "Terminal",
"title": "📢 Callout from @pumpfun_alpha: CALL",
"body": "Called Token ($CALL) - 3.5x since callout\nCurrent MC: $750k",
"url": "https://pump.fun/coin/CallTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"time": 1768853008938
}Published articles from pump.fun. Includes article details and associated token.
How to identify: tags.TYPE === "PUMPFUN_ARTICLE_PUBLISHED"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PUMPFUN_ARTICLE_PUBLISHED" |
| DOCUMENT_ID | Article document ID | "abc123..." |
| CONTRACT_ADDRESS | Token contract (optional) | "pump..." |
| CHAIN | Blockchain (optional) | "SOL" |
| PUMPFUN_URL | Pump.fun URL (optional) | "https://pump.fun/..." |
| HEADLINE | Article headline (optional) | "New Token Analysis" |
| PREVIEW | Article preview text (optional) | "In this article we explore..." |
| SYMBOL | Token symbol (optional) | "ART" |
| NAME | Token name (optional) | "Article Token" |
| IMAGE | Token image URL (optional) | "https://..." |
Example
{
"tags": {
"TYPE": "PUMPFUN_ARTICLE_PUBLISHED",
"DOCUMENT_ID": "article-doc-123456",
"CONTRACT_ADDRESS": "ArtTkn8vzmc7He4DDxzUFC4srV4MDPPjkvomm3pump",
"CHAIN": "SOL",
"PUMPFUN_URL": "https://pump.fun/articles/article-doc-123456",
"HEADLINE": "Deep Dive: The Rise of Meme Tokens",
"PREVIEW": "In this comprehensive analysis, we explore the factors driving...",
"SYMBOL": "MEME",
"NAME": "Meme Token"
},
"_id": "pumpfun-article-123456",
"source": "Terminal",
"title": "📰 Pump.fun Article: Deep Dive: The Rise of Meme Tokens",
"body": "In this comprehensive analysis, we explore the factors driving...",
"url": "https://pump.fun/articles/article-doc-123456",
"time": 1768853008938
}Fee claims from tracked BAGS tokens. Shows who claimed fees and their role.
How to identify: tags.TYPE === "BAGS_FEE_CLAIM"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "BAGS_FEE_CLAIM" |
| CONTRACT_ADDRESS | Token contract address | "pump..." |
| TOKEN_SYMBOL | Token symbol | "BAGS" |
| CLAIMER_WALLET | Claimer wallet address | "abc123..." |
| CLAIMER_TWITTER | Claimer Twitter handle | "@claimer" |
| CLAIMER_ROLE | Role (creator or royalty recipient) | "creator" |
| ROYALTY_PERCENTAGE | Royalty percentage (0-100) | "5" |
| SOL_AMOUNT | SOL amount claimed | "1.5" |
| TRANSACTION_ID | Transaction signature | "abc..." |
| CHAIN | Blockchain | "SOL" |
| IS_FIRST_CLAIM | Whether this is the first fee claim | "true" / "false" |
Example
{
"tags": {
"TYPE": "BAGS_FEE_CLAIM",
"CONTRACT_ADDRESS": "BagsTkn8vzmc7He4DDxzUFC4srV4MDPPjkvommpump",
"TOKEN_SYMBOL": "BAGS",
"CLAIMER_WALLET": "5xYkCBkquKJ3YAFtQGJtpGLW7jSYBBpH4kYVezQpump",
"CLAIMER_TWITTER": "@bags_creator",
"CLAIMER_ROLE": "creator",
"ROYALTY_PERCENTAGE": "5",
"SOL_AMOUNT": "2.5",
"TRANSACTION_ID": "5nYkCBkquKJ3YAFtQGJtpGLW7jSYBBpH4kYVezQtxsig",
"CHAIN": "SOL",
"IS_FIRST_CLAIM": "false"
},
"_id": "bags-fee-claim-123",
"source": "Terminal",
"title": "💰 BAGS Fee Claim: @bags_creator claimed 2.5 SOL",
"body": "Creator claimed 2.5 SOL from BAGS token fees (5% royalty)",
"time": 1768853008938
}New subdomains discovered for monitored websites.
How to identify: tags.TYPE === "NEW_SUBDOMAIN"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEW_SUBDOMAIN" |
| SUBDOMAIN | Full subdomain name | "api.example.com" |
| DOMAIN | Base domain | "example.com" |
Example
{
"tags": {
"TYPE": "NEW_SUBDOMAIN",
"SUBDOMAIN": "api.project.xyz",
"DOMAIN": "project.xyz"
},
"_id": "subdomain-api-project",
"source": "Terminal",
"title": "🌐 New subdomain: api.project.xyz",
"body": "New subdomain discovered for project.xyz",
"url": "https://api.project.xyz",
"time": 1768853008938
}Content or status changes detected on monitored website URLs.
How to identify: tags.TYPE === "URL_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "URL_CHANGE" |
| PREVIOUS_STATUS | Previous HTTP status code | "200" |
| CURRENT_STATUS | Current HTTP status code | "301" |
| REMOVED | Removed content (pipe-separated) | "old text|more old" |
| ADDED | Added content (pipe-separated) | "new text|more new" |
| CHANGE_PERCENTAGE | Percentage of content changed | "15.5" |
| CONTRACT_ADDRESS | CA found in added content (optional) | "pump..." |
| CHAIN | Blockchain if CA found (optional) | "SOL" |
Example
{
"tags": {
"TYPE": "URL_CHANGE",
"PREVIOUS_STATUS": "200",
"CURRENT_STATUS": "200",
"REMOVED": "Coming Soon|Q1 2024",
"ADDED": "Live Now|Mint Address: abc123pump",
"CHANGE_PERCENTAGE": "12.5",
"CONTRACT_ADDRESS": "abc123pump",
"CHAIN": "SOL"
},
"_id": "url-change-project",
"source": "Terminal",
"title": "📝 Website changed: project.xyz",
"body": "12.5% content changed\n+ Live Now, Mint Address: abc123pump\n- Coming Soon, Q1 2024",
"url": "https://project.xyz",
"time": 1768853008938
}Triggered when a tracked account changes their website URL in their profile.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "WEBSITE_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "WEBSITE_CHANGE" |
| AUTHOR_ID | User ID | "210297577" |
| AUTHOR_HANDLE | Username | "tekkaadan" |
| AUTHOR_NAME | Display name | "tekkaadan" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1288493134000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "3422" |
| AUTHOR_BIO | Bio | "AI App: https://t.co/..." |
| AUTHOR_LOCATION | Location | "Dark Continent" |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| OLD_WEBSITE | Previous website URL | "http://litcoin.tech" |
| NEW_WEBSITE | New website URL | "http://litcoin.app" |
| CONTRACT_ADDRESS | CA extracted from new website (optional) | "pump..." |
| CHAIN | Blockchain if CA found (optional) | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "WEBSITE_CHANGE",
"AUTHOR_ID": "210297577",
"AUTHOR_HANDLE": "tekkaadan",
"AUTHOR_NAME": "tekkaadan",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/2011532017687834624/CkeXR-KM_normal.jpg",
"AUTHOR_CREATED_AT": "1288493134000",
"AUTHOR_FOLLOWERS_COUNT": "3422",
"AUTHOR_BIO": "AI App: https://t.co/91GVyPNjwx | @litcoin_AI Previous @ocswap | @hinataio | @amplifytracker AI x Artist NFTs: @kawaaii_xyz TG: @tekkaadan",
"AUTHOR_LOCATION": "Dark Continent",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/210297577/1612601393",
"AUTHOR_WEBSITE": "http://litcoin.app",
"OLD_WEBSITE": "http://litcoin.tech",
"NEW_WEBSITE": "http://litcoin.app",
"SOURCE_URL": "https://x.com/tekkaadan",
"CATEGORY": "CUSTOM"
},
"_id": "tekkaadan-TWITTER_WEBSITE_CHANGE",
"source": "Terminal",
"title": "🌐 tekkaadan (@tekkaadan) updated website",
"body": "Old: http://litcoin.tech\n\nNew: http://litcoin.app",
"icon": "https://pbs.twimg.com/profile_images/2011532017687834624/CkeXR-KM_normal.jpg",
"url": "https://x.com/tekkaadan",
"time": 1775933539318
}Triggered when a tracked account changes their location in their profile.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "LOCATION_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "LOCATION_CHANGE" |
| AUTHOR_ID | User ID | "1469380022213488646" |
| AUTHOR_HANDLE | Username | "guneysol" |
| AUTHOR_NAME | Display name | "Guney" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1639162483000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "3469" |
| AUTHOR_BIO | Bio | "building @helius / prev. winner @colosseum, @uwaterloo" |
| AUTHOR_PROFILE_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| OLD_LOCATION | Previous location (empty string if none) | "" |
| NEW_LOCATION | New location | "ca t" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "LOCATION_CHANGE",
"AUTHOR_ID": "1469380022213488646",
"AUTHOR_HANDLE": "guneysol",
"AUTHOR_NAME": "Guney",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1856821941954301952/Dvvxfada_normal.jpg",
"AUTHOR_CREATED_AT": "1639162483000",
"AUTHOR_FOLLOWERS_COUNT": "3469",
"AUTHOR_BIO": "building @helius / prev. winner @colosseum, @uwaterloo",
"AUTHOR_LOCATION": "ca t",
"AUTHOR_PROFILE_BANNER": "https://pbs.twimg.com/profile_banners/1469380022213488646/1743716373",
"OLD_LOCATION": "",
"NEW_LOCATION": "ca t",
"SOURCE_URL": "https://x.com/guneysol",
"CATEGORY": "CUSTOM"
},
"_id": "guneysol-TWITTER_LOCATION_CHANGE",
"source": "Terminal",
"title": "📍 Guney (@guneysol) updated location",
"body": "Old: (empty)\n\nNew: ca t",
"icon": "https://pbs.twimg.com/profile_images/1856821941954301952/Dvvxfada_normal.jpg",
"url": "https://x.com/guneysol",
"time": 1775934293556
}Triggered when a tracked account adds or removes an organizational affiliation badge (e.g., affiliated with @xai, @Polymarket).
How to identify: tags.TYPE === "PROFILE" && (tags.SUBTYPE === "AFFILIATE_ADDED" || tags.SUBTYPE === "AFFILIATE_REMOVED")
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Affiliate added or removed | "AFFILIATE_ADDED" / "AFFILIATE_REMOVED" |
| AUTHOR_ID | User ID | "45959829" |
| AUTHOR_HANDLE | Username | "timeyoutakeit" |
| AUTHOR_NAME | Display name | "Amy" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| AUTHOR_CREATED_AT | Account creation date | "1244585521000" |
| AUTHOR_FOLLOWERS_COUNT | Follower count | "2580" |
| AUTHOR_FOLLOWING_COUNT | Following count | "1018" |
| AUTHOR_BIO | Bio | "Everything docs. product @GoogleDeepmind" |
| AUTHOR_LOCATION | Location | " 🇮🇪 " |
| AUTHOR_WEBSITE | Website | "https://..." |
| AUTHOR_BANNER | Banner URL | "https://pbs.twimg.com/profile_banners/..." |
| AUTHOR_IS_BLUE_VERIFIED | Blue verified status | "true" |
| AUTHOR_AFFILIATE_DESCRIPTION | Affiliate org name on author profile | "Google AI Studio" |
| ORG_HANDLE | Organization handle | "GoogleAIStudio" |
| ORG_NAME | Organization display name | "Google AI Studio" |
| ORG_ID | Organization user ID | "1742923424056713217" |
| ORG_ICON | Organization avatar URL | "https://pbs.twimg.com/..." |
| ORG_BIO | Organization bio | "The fastest path from prompt to prototype..." |
| ORG_BANNER | Organization banner URL | "https://pbs.twimg.com/profile_banners/..." |
| ORG_LOCATION | Organization location | "It's time to build" |
| ORG_WEBSITE | Organization website | "https://ai.studio/build" |
| ORG_FOLLOWERS_COUNT | Organization follower count | "153626" |
| ORG_FOLLOWING_COUNT | Organization following count | "2" |
| ORG_VERIFIED_TYPE | Organization verification type | "business" |
| ORG_CREATED_AT | Organization account creation date | "1704380306000" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "AFFILIATE_ADDED",
"AUTHOR_ID": "45959829",
"AUTHOR_HANDLE": "timeyoutakeit",
"AUTHOR_NAME": "Amy",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/378800000299560643/4bf4c4477bd330523108cdaeaf7c7731_normal.jpeg",
"AUTHOR_CREATED_AT": "1244585521000",
"AUTHOR_FOLLOWERS_COUNT": "2580",
"AUTHOR_FOLLOWING_COUNT": "1018",
"AUTHOR_BIO": "Everything docs. \n\nproduct @GoogleDeepmind\nPrev @vercel, @GitHub, @microsoft, @xamarinhq\n\nNone of my opinions are my own.",
"AUTHOR_LOCATION": " 🇮🇪 ",
"AUTHOR_IS_BLUE_VERIFIED": "true",
"AUTHOR_BANNER": "https://pbs.twimg.com/profile_banners/45959829/1705256452",
"AUTHOR_AFFILIATE_DESCRIPTION": "Google AI Studio",
"ORG_HANDLE": "GoogleAIStudio",
"ORG_NAME": "Google AI Studio",
"ORG_ID": "1742923424056713217",
"ORG_ICON": "https://pbs.twimg.com/profile_images/1957558782067896323/6jXpPKD4_normal.png",
"ORG_BIO": "The fastest path from prompt to prototype to production with Gemini",
"ORG_BANNER": "https://pbs.twimg.com/profile_banners/1742923424056713217/1773068211",
"ORG_LOCATION": "It's time to build",
"ORG_WEBSITE": "https://ai.studio/build",
"ORG_FOLLOWERS_COUNT": "153626",
"ORG_VERIFIED_TYPE": "business",
"ORG_CREATED_AT": "1704380306000",
"SOURCE_URL": "https://x.com/timeyoutakeit"
},
"_id": "timeyoutakeit-TWITTER_AFFILIATE_CHANGE-AFFILIATE_ADDED-googleaistudio",
"source": "Terminal",
"title": "🏢 @timeyoutakeit (Amy) affiliated with @GoogleAIStudio (Google AI Studio)",
"body": "\n\n📝 Everything docs. \n\nproduct @GoogleDeepmind\nPrev @vercel, @GitHub, @microsoft, @xamarinhq\n\nNone of my opinions are my own.\n\n👥 2580 followers\n📍 🇮🇪 ",
"icon": "https://pbs.twimg.com/profile_images/378800000299560643/4bf4c4477bd330523108cdaeaf7c7731_normal.jpeg",
"url": "https://x.com/timeyoutakeit",
"time": 1775501804056,
"image": "https://pbs.twimg.com/profile_banners/45959829/1705256452"
}Triggered when a tracked account pins, unpins, or changes their pinned tweet. This unified type combines old pin and new pin information in a single event.
How to identify: tags.TYPE === "PROFILE" && tags.SUBTYPE === "PINNED_CHANGE"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "PROFILE" |
| SUBTYPE | Event type | "PINNED_CHANGE" |
| AUTHOR_ID | User ID | "779657810405654528" |
| AUTHOR_HANDLE | Username | "TehranTimes79" |
| AUTHOR_NAME | Display name | "Tehran Times" |
| AUTHOR_ICON | Avatar URL | "https://pbs.twimg.com/..." |
| OLD_TWEET_ID | ID of previously pinned tweet (if any) | "2042666182533169341" |
| OLD_TWEET_LINK | Link to previously pinned tweet | "https://x.com/TehranTimes79/status/..." |
| OLD_TWEET_TEXT | Content of previously pinned tweet | "Tomorrow's edition of the Tehran Times..." |
| OLD_TWEET_TEXT_TRANSLATED | Translated old tweet | "Translated old content..." |
| OLD_IMAGE | Image from old pinned tweet | "https://pbs.twimg.com/media/..." |
| OLD_VIDEO | Video from old pinned tweet | "https://video.twimg.com/..." |
| OLD_VIDEO_THUMBNAIL | Thumbnail for old video | "https://pbs.twimg.com/..." |
| OLD_IMAGE2 / OLD_IMAGE3 / OLD_IMAGE4 | Additional images from old pinned tweet | "https://pbs.twimg.com/media/..." |
| OLD_CONTRACT_ADDRESS | CA in old pinned tweet | "oldCA123pump" |
| OLD_CHAIN | Chain for old CA | "SOL" |
| NEW_TWEET_ID | ID of newly pinned tweet (if any) | "2043033840940105785" |
| NEW_TWEET_LINK | Link to newly pinned tweet | "https://x.com/TehranTimes79/status/..." |
| NEW_TWEET_TEXT | Content of newly pinned tweet | "Tomorrow's edition of the Tehran Times..." |
| NEW_TWEET_TEXT_TRANSLATED | Translated new tweet (if applicable) | "Translated content..." |
| NEW_IMAGE | Image from new pinned tweet | "https://pbs.twimg.com/media/..." |
| NEW_IMAGE2 / NEW_IMAGE3 / NEW_IMAGE4 | Additional images from new pinned tweet | "https://pbs.twimg.com/media/..." |
| NEW_VIDEO | Video from new pinned tweet | "https://video.twimg.com/..." |
| NEW_VIDEO_THUMBNAIL | Thumbnail for new video | "https://pbs.twimg.com/..." |
| NEW_CONTRACT_ADDRESS | CA in new pinned tweet | "abc123pump" |
| NEW_CHAIN | Chain for new CA | "SOL" |
| CONTRACT_ADDRESS | Detected contract address | "abc123pump" |
| CHAIN | Blockchain of contract | "SOL" |
| LABEL | Account label (user-defined) | "DeFi Protocol" |
| CATEGORY | Account category | "CUSTOM" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "PROFILE",
"SUBTYPE": "PINNED_CHANGE",
"AUTHOR_ID": "779657810405654528",
"AUTHOR_HANDLE": "TehranTimes79",
"AUTHOR_NAME": "Tehran Times",
"AUTHOR_ICON": "https://pbs.twimg.com/profile_images/1794657140755386368/6gwo_pyC_normal.jpg",
"OLD_TWEET_ID": "2042666182533169341",
"OLD_TWEET_LINK": "https://x.com/TehranTimes79/status/2042666182533169341",
"OLD_TWEET_TEXT": "Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth",
"OLD_IMAGE": "https://pbs.twimg.com/media/HFkCDDKakAEOLOt.jpg",
"NEW_TWEET_ID": "2043033840940105785",
"NEW_TWEET_LINK": "https://x.com/TehranTimes79/status/2043033840940105785",
"NEW_TWEET_TEXT": "Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth",
"NEW_IMAGE": "https://pbs.twimg.com/media/HFpQcXJb0AAL8I0.jpg",
"SOURCE_URL": "https://x.com/TehranTimes79/status/2043033840940105785",
"CATEGORY": "CUSTOM"
},
"_id": "tehrantimes79-TWITTER_PINNED_CHANGE-2043033840940105785",
"source": "Terminal",
"title": "📌 @TehranTimes79 changed pinned tweet",
"body": "Old: Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth\n\nNew: Tomorrow's edition of the Tehran Times\n\nStay tuned for straight truth",
"icon": "https://pbs.twimg.com/profile_images/1794657140755386368/6gwo_pyC_normal.jpg",
"url": "https://x.com/TehranTimes79/status/2043033840940105785",
"time": 1775932226219,
"image": "https://pbs.twimg.com/media/HFpQcXJb0AAL8I0.jpg",
"info": {
"twitterId": "779657810405654528",
"isReply": false,
"isSelfReply": false,
"isRetweet": false,
"isQuote": false,
"profileChange": {
"field": "pinned",
"before": "https://x.com/TehranTimes79/status/2042666182533169341",
"after": "https://x.com/TehranTimes79/status/2043033840940105785"
}
}
}New videos from tracked YouTube channels.
How to identify: tags.TYPE === "NEW_YOUTUBE_VIDEO"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEW_YOUTUBE_VIDEO" |
| CHANNEL_ID | YouTube channel ID | "UCxxxxxxxxxx" |
| CHANNEL_NAME | Channel display name | "Coin Bureau" |
| CHANNEL_URL | Link to the channel | "https://www.youtube.com/channel/UCxxxxxxxxxx" |
| CHANNEL_AVATAR | Channel profile picture (absent when the channel has none) | "https://yt3.googleusercontent.com/xxxx" |
| VIDEO_ID | YouTube video ID | "abc123" |
| VIDEO_TITLE | Title of the video | "Market Analysis 2024" |
| VIDEO_URL | Link to the video | "https://www.youtube.com/watch?v=abc123" |
| VIDEO_THUMBNAIL | Video cover image, highest resolution available | "https://i.ytimg.com/vi/abc123/maxresdefault.jpg" |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "NEW_YOUTUBE_VIDEO",
"CHANNEL_ID": "UCxxxxxxxxxx",
"CHANNEL_NAME": "Coin Bureau",
"CHANNEL_URL": "https://www.youtube.com/channel/UCxxxxxxxxxx",
"CHANNEL_AVATAR": "https://yt3.googleusercontent.com/xxxx",
"VIDEO_ID": "abc123",
"VIDEO_TITLE": "Crypto Market Analysis - Weekly Update",
"VIDEO_URL": "https://www.youtube.com/watch?v=abc123",
"VIDEO_THUMBNAIL": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg"
},
"_id": "youtube-video-abc123",
"source": "Terminal",
"title": "New YouTube video from Coin Bureau: Crypto Market Analysis - Weekly Update",
"body": "Crypto Market Analysis - Weekly Update",
"url": "https://www.youtube.com/watch?v=abc123",
"image": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg",
"time": 1768853008938
}Transcript availability for tracked YouTube videos.
How to identify: tags.TYPE === "NEW_YOUTUBE_VIDEO_TRANSCRIPT"
Tags Reference
| Tag | Description | Example |
|---|---|---|
| TYPE | Event category | "NEW_YOUTUBE_VIDEO_TRANSCRIPT" |
| CHANNEL_ID | YouTube channel ID | "UCxxxxxxxxxx" |
| VIDEO_TITLE | Title of the video | "Market Analysis 2024" |
| VIDEO_SUMMARY | Summary of transcript content | "Key points discussed..." |
Example
{
"show_feed": true,
"show_notif": true,
"tags": {
"TYPE": "NEW_YOUTUBE_VIDEO_TRANSCRIPT",
"CHANNEL_ID": "UCxxxxxxxxxx",
"VIDEO_TITLE": "Crypto Market Analysis - Weekly Update",
"VIDEO_SUMMARY": "Key points: Bitcoin consolidating at $50k, Ethereum upgrade incoming, altseason indicators present."
},
"_id": "youtube-transcript-abc123",
"source": "Terminal",
"title": "📝 Transcript: Crypto Market Analysis - Weekly Update",
"body": "Key points: Bitcoin consolidating at $50k, Ethereum upgrade incoming, altseason indicators present.",
"url": "https://youtube.com/watch?v=abc123",
"time": 1768853008938
}Important
Add the Bot to Your Group
Click the button below to add the Bark bot to your Telegram group chat:
Pick your group and confirm — that's the whole setup. Bark recognises you from the Telegram account that adds it and activates the group on the spot. Nothing to copy or paste.
If it can't tell who you are — someone else adds the bot, or your Telegram isn't connected yet — it posts an Activate this group button in the chat for the subscription holder to tap. Connect your Telegram on the Account page to skip that step.
Configure Settings
Use /track and /untrack commands to start tracking Twitter accounts, wallets, websites or domains.
You can also configure settings on the Settings page
Add Admins (optional)
As the subscription holder you can do everything yourself. If you want to let others in the group track/untrack things and configure settings, grant them admin access:
/add_admin @usernameThe top bar
🔎 Search
Type to filter what's on screen
🔊 Sounds
One click mutes everything
+ Add column
Run up to 8 feeds side by side
⚙️ Customize
Colors, sounds, keywords, layout
🟢 Connection dot
Green means live — click to reconnect
︿ Collapse
Hide the top bar for more feed
Columns
Move & resize
Drag a column to move it, drag its edge to resize it
Choose what's inside
Each column can show only the sources and accounts you pick
Live counter
Every column shows how many alerts it has caught
On your phone
One single feed with everything in it
On every card
Customize your feed (⚙️)
News Types
A color and a sound for every kind of alert
Accounts
Give any account its own color and sound
Keywords
Highlight the words that matter to you
Styles
Save a color + sound combo, reuse it anywhere
Display
Card size, timestamps, text size, video autoplay
Backup
Export / import your whole setup, master volume, reset
Good to know
History
Opens with the latest 100 alerts, keeps up to 1,000
Stays on this device
Your look & sounds are saved per browser — use Export to move them
Full details and prices: bark.gg/plans
First steps in the DM bot
/login <API_KEY>
Connect your Bark account (key is on the Account page)
/status
Your account and how much of your plan you're using
/help
The full command menu, right in the chat
/track 0x1234…5678 WhaleA wallet, nicknamed Whale/track elonmuskAn X account/track warpcast.com/vitalikA Farcaster account/track https://example.comA page, watched for changes/track example.comA domain, watched for new subdomains🔔 Notification buttons
Add Untrack / Delete buttons to alerts
🎨 Display
Ticker style, CA display, wallet balance
📈 Trading platforms
Your platform per chain, for Trade links
📰 News Articles: pick publishers and their sections.
Admins
Everything — added with /add_admin, can also manage the group on the website
Trackers
Track and untrack only — added with /add_tracker
Untrack and Delete are off by default — turn them on in /customize → Notification buttons.
Prefer clicking to typing?
Admins
- •Can do everything, including /setup
- •Can edit the server's settings on the website
- •Chosen in /setup → Admin Access
Trackers
- •Can track and untrack things
- •Can't run /setup or edit website settings
- •Chosen in /setup → Tracker Access — per channel if you want
In a server
Activate your subscription, choose admins & trackers, customize the feed
In your DMs
Customize your personal feed
Inside Customize
🔔 Notifications
Add Untrack / Delete buttons to alerts
🎨 Display
Ticker style, CA display, wallet balance
📈 Trading platforms
Your platform per chain, for Trade links
Untrack and Delete are off by default — turn them on in /setup → Customize → Notifications. In servers, only admins & trackers can press them.
ocr to any message with an image — Bark pulls out the text, translates Chinese, and links any CA it finds.