# Twitter {% hint style="info" %} Twitter tasks automate trades from Twitter activity. Five modes track different signals and fire buys or sells automatically. Available across Ethereum, Base, and BSC. Use the Blockchain Selector at the top of each config to switch chains. {% endhint %} {% hint style="danger" %} Twitter tasks expire after 7 days. If you don't stop and restart the task within that period, it will be automatically set as inactive. {% endhint %} *** ### Setup {% stepper %} {% step %} Access the Twitter menu from the home menu or use the /twitter command.
{% endstep %} {% step %} Tap Add new config.
| Button | Action | | ------------------- | -------------------------------------------------------- | | Blockchain Selector | Use the arrows to select the target blockchain. | | Add new config | Add a new Twitter tracking configuration. | | Mass Create | Bulk create configurations for multiple target accounts. | | Pause All | Pause all active Twitter tasks on the selected chain. | | Start All | Start all paused Twitter tasks on the selected chain. | | Delete All | Delete all Twitter configurations on the selected chain. | | {% endstep %} | | {% step %} #### Select Task Type
A menu appears with five modes. Each one tracks a different Twitter signal: * **CA Scanner**: triggers when a contract address appears in a tweet from the tracked account. * **Engagement**: triggers when the tracked account replies to, retweets, or quote tweets a specific tweet. * **Follow / Unfollow**: triggers when an account follows or unfollows another user. * **Posts & Replies**: triggers when the tracked account posts, replies, retweets, or quote tweets. * **Tweet Delete**: triggers when a specific tweet is deleted by its author. {% endstep %} {% endstepper %} *** ### Create Twitter Task {% tabs %} {% tab title="CA Scanner" %} Buys contracts posted by the tracked account in tweets, retweets, replies, or quotes. **Flow** {% stepper %} {% step %} Select CA Scanner from the task type menu. The standard config opens. {% endstep %} {% step %} Set the Twitter Handle and any additional filters, then toggle the task Active. {% endstep %} {% endstepper %} **Config**
| Field | Description | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Blockchain Selector | Use the arrows to select the target blockchain. Ethereum, Base, or BSC. | | Wallet | Wallet used for the task. | | Config Name | Custom name for this task. | | Max Buy Count | Maximum contracts the task will buy. Set to 1 for the first only, 2 for the first two, and so on. Changing the target does not reset this counter. | | Current Trades | Number of contracts this configuration has bought so far. | | Reset Count | Resets Current Trades back to zero. | | Buy | Amount spent per buy, in the native currency. ETH on Ethereum and Base, BNB on BSC. | | Gas | Max Priority Fee in GWEI. Max Fee = Base Fee + (Priority Fee x 2). | | Slippage | Buy slippage percentage. | | Buy Tip | Tip in the native currency to prioritize execution. ETH on Ethereum and Base, BNB on BSC. | | MEV Protect | Routes transactions through BloXroute to prevent MEV. Disabled uses the custom node. | | Twitter Handle | Twitter handle to track. URL or username without the @. | | Twitter Tweet | Buys contracts posted in an original tweet. Includes contracts taken from the quoted text in a quote tweet. | | Twitter Reply | Buys contracts posted in a reply. | | Twitter RT | Buys contracts taken from the original tweet on a retweet. | | Twitter Quote | Buys contracts posted in a quote tweet. | | Twitter OCR | Detects and buys contracts from images posted by the target account. | | Min Market Cap | Minimum market cap required at the moment of the post. Below threshold, the buy is skipped. | | Max Market Cap | Maximum market cap allowed at the moment of the post. Above threshold, the buy is skipped. | | Min Token Age | Minimum time since token creation. For migrated coins, counted from DEX listing. Only trades from September 22, 2025 onward are included due to EVM limits. | | Max Token Age | Maximum time since token creation. For migrated coins, counted from DEX listing. Only trades from September 22, 2025 onward are included due to EVM limits. | | Start | Task start time (UTC). | | End | Task end time (UTC). | | Active | Activate/Deactivate the config. | | Limit Orders | Attach limit orders to the task. See the dedicated guide. | | Duplicate | Duplicate the current config. | | Delete | Delete the current config. | | {% endtab %} | | {% tab title="Engagement" %} Triggers a buy when the tracked account replies to, retweets, or quote tweets a specific tweet. **Flow** {% stepper %} {% step %} Enter the Twitter handle of the user interacting with the tweet (reply, repost, quote).
{% endstep %} {% step %} Enter the tweet URL or ID to monitor for interactions.
{% endstep %} {% step %} Enter the token address to buy or sell when the action is detected.
{% endstep %} {% step %} Select which actions should trigger a trade, then continue to configure the task. Toggle Reply, Repost, or Quote, then click Confirm.
{% endstep %} {% endstepper %} **Config**
| Field | Description | | ------------------- | ----------------------------------------------------------------------------------------- | | Blockchain Selector | Use the arrows to select the target blockchain. Ethereum, Base, or BSC. | | Wallet | Wallet used for the task. | | Config Name | Custom name for this task. | | Max Buy Count | Maximum buys the task will execute. Changing the target does not reset this counter. | | Current Trades | Number of buys this configuration has executed so far. | | Reset Count | Resets Current Trades back to zero. | | Buy | Amount spent per buy, in the native currency. ETH on Ethereum and Base, BNB on BSC. | | Gas | Max Priority Fee in GWEI. Max Fee = Base Fee + (Priority Fee x 2). | | Slippage | Buy slippage percentage. | | Buy Tip | Tip in the native currency to prioritize execution. ETH on Ethereum and Base, BNB on BSC. | | MEV Protect | Routes transactions through BloXroute to prevent MEV. Disabled uses the custom node. | | Target Account | Handle of the account whose interactions you want to track. | | Tweet | URL or numeric ID of the tweet to monitor. | | Token | Contract address of the token to buy. | | Twitter Reply | Buys when the Target Account replies to the tweet. | | Twitter RT | Buys when the Target Account retweets the tweet. | | Twitter Quote | Buys when the Target Account quote tweets the tweet. | | Start | Task start time (UTC). | | End | Task end time (UTC). | | Active | Activate/Deactivate the config. | | Limit Orders | Attach limit orders to the task. See the dedicated guide. | | Duplicate | Duplicate the current config. | | Delete | Delete the current config. | | {% endtab %} | | {% tab title="Follow / Unfollow" %} Triggers a buy or sell when an account follows or unfollows another user. **Flow** {% stepper %} {% step %} Follow the prompts in the Telegram messages to enter the Target Account, the Followed Account, and the Token Address. {% endstep %} {% step %} The final menu shows the action toggles, the Side, and a Continue button. Toggle Follow or Unfollow, pick Side (Buy or Sell), then click Continue. The standard config opens.
{% endstep %} {% endstepper %} **Config**
| Field | Description | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | Blockchain Selector | Use the arrows to select the target blockchain. Ethereum, Base, or BSC. | | Wallet | Wallet used for the task. | | Config Name | Custom name for this task. | | Max Buy Count | Maximum trades the task will execute. Changing the target does not reset this counter. | | Current Trades | Number of trades this configuration has executed so far. | | Reset Count | Resets Current Trades back to zero. | | Buy / Sell | Native currency amount for a buy, or percentage of token holdings for a sell. The label and unit follow the Side selection. | | Gas | Max Priority Fee in GWEI. Max Fee = Base Fee + (Priority Fee x 2). | | Slippage | Slippage percentage for the order. | | Buy Tip | Tip in the native currency to prioritize execution. ETH on Ethereum and Base, BNB on BSC. | | MEV Protect | Routes transactions through BloXroute to prevent MEV. Disabled uses the custom node. | | Target Account | Handle of the account whose follow activity you want to track. | | Followed Account | Handle of the account being followed or unfollowed. Set to trigger only when the Target Account follows or unfollows this specific user. | | Token | Contract address of the token to buy or sell. | | Side | Buy to open a position. Sell to close one. | | Follow | Triggers when the Target Account follows a new user. | | Unfollow | Triggers when the Target Account unfollows a user. | | Start | Task start time (UTC). | | End | Task end time (UTC). | | Active | Activate/Deactivate the config. | | Limit Orders | Attach limit orders to the task. See the dedicated guide. | | Duplicate | Duplicate the current config. | | Delete | Delete the current config. | | {% endtab %} | | {% tab title="Posts & Replies" %} Triggers a buy or sell when the tracked account posts, replies, retweets, or quote tweets. **Flow** {% stepper %} {% step %} Follow the prompts in the Telegram messages to enter the Target Account and the Token Address. The Configure Actions menu opens. Toggle Tweet, Reply, Repost, and Quote to pick the actions that trigger a trade. Pick Side (Buy or Sell), then click Continue.
{% endstep %} {% step %} The Original Poster prompt appears.
{% endstep %} {% step %} The Text Keywords prompt appears. After this, the standard config opens.
{% endstep %} {% endstepper %} **Config**
| Field | Description | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Blockchain Selector | Use the arrows to select the target blockchain. Ethereum, Base, or BSC. | | Wallet | Wallet used for the task. | | Config Name | Custom name for this task. | | Max Buy Count | Maximum trades the task will execute. Changing the target does not reset this counter. | | Current Trades | Number of trades this configuration has executed so far. | | Reset Count | Resets Current Trades back to zero. | | Buy / Sell | Native currency amount for a buy, or percentage of token holdings for a sell. The label and unit follow the Side selection. | | Gas | Max Priority Fee in GWEI. Max Fee = Base Fee + (Priority Fee x 2). | | Slippage | Slippage percentage for the order. | | Buy Tip | Tip in the native currency to prioritize execution. ETH on Ethereum and Base, BNB on BSC. | | MEV Protect | Routes transactions through BloXroute to prevent MEV. Disabled uses the custom node. | | Target Account | Handle of the account whose posting activity you want to track. | | Original Poster | Handle of the original poster of the tweet being interacted with. Filters replies, retweets, and quotes to those that involve this poster's tweets. Set to Any to disable the filter. | | Token | Contract address of the token to buy or sell. | | Side | Buy to open a position. Sell to close one. | | Keywords | List of keywords to match against the post text. The task fires when any keyword appears in the post or the quoted/replied tweet; capitalization is ignored. Set to Any to disable. Up to 500. | | Twitter Tweet | Triggers when the Target Account posts an original tweet. | | Twitter Reply | Triggers when the Target Account replies. | | Twitter RT | Triggers when the Target Account retweets. | | Twitter Quote | Triggers when the Target Account quote tweets. | | Start | Task start time (UTC). | | End | Task end time (UTC). | | Active | Activate/Deactivate the config. | | Limit Orders | Attach limit orders to the task. See the dedicated guide. | | Duplicate | Duplicate the current config. | | Delete | Delete the current config. | | {% endtab %} | | {% tab title="Tweet Delete" %} Triggers a buy or sell when a specific tweet is deleted by its author. **Flow** {% stepper %} {% step %} Follow the prompts in the Telegram messages to enter the Tweet URL or ID and the Token Address. {% endstep %} {% step %} The Configure Task menu appears. The task fires when the tweet above is deleted. Pick Side (Buy or Sell), then click Confirm. The standard config opens.
{% endstep %} {% endstepper %} **Config**
| Field | Description | | ------------------- | --------------------------------------------------------------------------------------------------------------------------- | | Blockchain Selector | Use the arrows to select the target blockchain. Ethereum, Base, or BSC. | | Wallet | Wallet used for the task. | | Config Name | Custom name for this task. Auto-generated and editable. | | Buy / Sell | Native currency amount for a buy, or percentage of token holdings for a sell. The label and unit follow the Side selection. | | Fee | Max Priority Fee in GWEI. Label appears as Buy Fee or Sell Fee depending on Side. | | Slippage | Slippage percentage for the order. Label appears as Buy Slippage or Sell Slippage depending on Side. | | MEV Protect | Routes transactions through BloXroute to prevent MEV. Label appears as Buy Protection or Sell Protection depending on Side. | | Tip | Tip in the native currency to prioritize execution. Label appears as Buy Tip or Sell Tip depending on Side. | | Tweet | URL or numeric ID of the tweet to monitor for deletion. | | Token | Contract address of the token to buy or sell. | | Side | Buy to open a position. Sell to close one. | | Start | Task start time (UTC). | | End | Task end time (UTC). | | Active | Activate/Deactivate the config. | | Duplicate | Duplicate the current config. | | Delete | Delete the current config. | | {% endtab %} | | | {% endtabs %} | | *** ### Auto Orders When you create a task that supports auto orders, the bot prompts you to attach an existing auto order group. Pick a group from the list, or select No Auto Orders to skip.
*** ### Limit Orders Limit Orders work the same as today. The dedicated menu lives inside each task config. Open Limit Orders from any config to manage the attached orders. See the dedicated guide for the full configuration reference. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.bloombot.app/evm/evm-bot/twitter.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.