Twitter-Solana-Sales-Bot

Preface

[Back to contents]

      This bot allows for custom tweet text and fast response times. The bot utilizes MagicEden's GET/collections/:symbol/activities API call, responding to sales in less than a minute while allowing for NFT image uploading and metadata access through MagicEden's API. This bot is designed to run on an external server.

Note: this bot was tested on an EC2 AWS instance and a Raspberry Pi 4. Usable on Windows/Unix based servers.

Contents

• Demo
• Setup
  • Installing
  • Adding Credentials
  • Running
• Config (Customize)
• Free Use
• Find Me
• Tip Jar

Demo

[Back to contents]

• Used by BR1SALESBOT
• Used by ThreeRarity (I used the core code and extended on it by implementing the HowRare API for rarity and attributes)

Setup

[Back to contents]

Installing the Bot

[Back to contents]

Clone and install Python requirements with

git clone https://github.com/WilliamAmbrozic/Responsive-Solana-NFT-Sales-Bot.git
cd Responsive-Solana-NFT-Sales-Bot
pip install -r requirements.txt

Adding Credentials

[Back to contents]

1. Add Your NFT MagicEden Collection Symbol to the Config.json

      A collection's symbol can be found by going to https://magiceden.io/ and searching for your collection's marketplace page (click the search bar). Look at the url and copy the text appearing directly after the last dash following "marketplace" as highlighted above. This text is your collection's symbol, this is needed for the bot to know what collection to tweet out. Paste this value in the ./config/config.json attribute called ME_symbol as seen here.

2. Add your Twitter Developer Credentials to the Config.json

      A. Make a Twitter account and sign up to become a Twitter developer here.

      B. Make sure your Twitter developer account has elevated access for image uploading here.

      C. Make sure that the Access Token and Secret has been created with Read and Write permissions.

      D. Place your Twitter developer credentials in ./config/config.json as seen here.

Running the Bot

[Back to contents]

Run with

python3 bot.py

Or recommended with (if you do not want an ssh exit or general exit to halt the bot)

nohup python3 bot.py &

Config

[Back to contents]

The config file ./config/config.json will look something like this:

{
  "ME_symbol": "ADD_YOUR_SYMBOL_HERE",
  "twitter_credentials": {
    "bearer_token": "ADD_YOURS_HERE",
    "consumer_key": "ADD_YOURS_HERE",
    "consumer_secret": "ADD_YOURS_HERE",
    "access_token": "ADD_YOURS_HERE",
    "access_token_secret": "ADD_YOURS_HERE"
  },
  "tweet_text": "BOOM💥 [-n] just sold for [-p] ([-f])",
  "fiat_currency": "USD",
  "TPS": 2,
  "activities_per_call": 500
}

Optional Attributes

tweet_text: You can customize the text that is tweeted out with the NFT image. Tweet text follows this notation (the bot will replace the following syntax with ...):

• [-n]: The NFT name (Ex. SolGod 0001)
• [-f]: The fiat price with respect to the fiat_currency value described below (Ex. $199.19 USD)
• [-p]: The sale price in Solana (Ex. 10 SOL)
• [-o]: The buyers wallet address
• [-m]: The NFT's mint address (This can easily be appended to a MagicEden item link to get the sale link as seen in the demo like so: https://magiceden.io/item-details/[-m])
• [-i]: The NFT image url (Not needed to display the NFT image)
• [-s]: The source of the sale (Ex. magiceden_v2)
• [-b]: The blockTime the transaction occured at (Ex. 21647306453)

For example,

BOOM💥 [-n] just sold for [-p] ([-f])

would become

BOOM💥 SolGod #001 just sold for 50.24 SOL ($5000.37 USD)

fiat_currency: The bot currently supports the following currencies: EUR, USD, CAD, JPY, GPB, AUD, CNY, INR. Change this value to change the currency in which Solana is converted if you choose to output fiat price.

Free Use

[Back to contents]

      This bot is 100% free to use. Use of this bot for your project is encouraged. No credit is needed. If you find this bot useful and insist on crediting the creator, you can add @williamambrozic in the bot's Twitter bio or have the bot follow @williamambrozic on Twitter. Thank you 🙂

Find Me

• williamambrozic.info
• Twitter

Solana Tip Jar

• wia.sol
• 8vU6RfyFDk9WriVgaJohBxqtE86TLtjAR8cPWjdU6zEN

Bitcoin

• bc1qa7vkam2w4cgw8njqx976ga5ns8egsq3yzxzlrt