https://github.com/dsgriffin/opensea-sales-twitter-bot

A Twitter bot that tweets Opensea sales for a given collection 🐳
https://github.com/dsgriffin/opensea-sales-twitter-bot

ethereum nft opensea twitter-bot web3

Last synced: 19 days ago
JSON representation

A Twitter bot that tweets Opensea sales for a given collection 🐳

• Host: GitHub
• URL: https://github.com/dsgriffin/opensea-sales-twitter-bot
• Owner: dsgriffin
• License: isc
• Created: 2021-05-31T11:31:14.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2022-08-02T12:23:21.000Z (over 2 years ago)
• Last Synced: 2023-11-07T17:59:25.777Z (about 1 year ago)
• Topics: ethereum, nft, opensea, twitter-bot, web3
• Language: JavaScript
• Homepage:
• Size: 62.5 KB
• Stars: 192
• Watchers: 10
• Forks: 302
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: license.txt

Awesome Lists containing this project

README

        
# OpenSea Sales Twitter Bot 🤖

A (quickly put together) bot that monitors Opensea sales for a given collection & then posts them to Twitter.

## Want to include sales from other markets (X2Y2, LooksRare etc.) too? ⚠️ 

To track sales across multiple marketplaces (X2Y2, LooksRare etc.), use my new repo [NFT Sales Twitter Bot](https://github.com/dsgriffin/nft-sales-twitter-bot) instead.

## Donations 💵

If you find this script/repo useful for your project, any ETH/Altcoin/NFT donations are greatly appreciated 🙏

Eth Address: 0xDCA88f66CEc8972D23DE7d5e69c40E087C92132f

## Requirements 📝

- [Twitter Developer Account](https://developer.twitter.com/en/apply-for-access) (with [Elevated Access](https://developer.twitter.com/en/portal/products/elevated), as we need v1.1 endpoint access)

- A OpenSea API Key (request one [here](https://docs.opensea.io/reference/api-overview))

- Heroku Account (a free account **should** be fine **if** you tweak the project to run less often than every minute (by default it is every minute), otherwise a $7 a month dyno instance is more than enough).

## Setup 🔧

- Clone/Fork/Copy this project to your local public/private git repo

- Create a Twitter Developer App (make sure you change it to have both read/write permissions)

- Create a new Heroku app & set it as a remote branch of your git repo (see [Heroku Remote](https://devcenter.heroku.com/articles/git#creating-a-heroku-remote))

- Make sure you are logged in to the Twitter account you want the bot to run on (as the next step will be authorizing the bot to post on your account)

- Install [Twurl](https://github.com/twitter/twurl) and, using your Twitter Developer consumer key & secret, generate the access token & access secret

In the Settings section of your Heroku app you'll see a Config Vars section. Add the following config vars:

- **CONSUMER_KEY** - Your Twitter Developer App's Consumer Key

- **CONSUMER_SECRET** - Your Twitter Developer App's Consumer Secret

- **ACCESS_TOKEN_KEY** - The Access Token Key of the Twitter Account your bot is posting from

- **ACCESS_TOKEN_SECRET** - The Access Token Secret of the Twitter Account your bot is posting from

- **OPENSEA_COLLECTION_SLUG** - The OpenSea collection name you wish to track (e.g. `cryptopunks`)

- **X_API_KEY** - Your unique OpenSea API key

Now you're ready to release - just push up the code via. git to the Heroku remote (see [Heroku Remote](https://devcenter.heroku.com/articles/git#creating-a-heroku-remote) if unsure how).

Make sure you are using `worker` dynos and not `web` dynos - you can set this in the CLI your project with:

```sh

heroku ps:scale web=0

heroku ps:scale worker=1

```

## Modification 🛠

By default I am just include the name, price in eth & usd, a hashtag or two and a link to the NFT on OpenSea. Check out the [OpenSea Events API](https://docs.opensea.io/reference#retrieving-asset-events) if you want to include additional info (such as seller/buyer addresses etc.).

There is `tweetWithImage` function that you can use instead of the default `tweet` method if you prefer - this will display the full image file as part of the tweet, instead of the standard OpenSea preview image.

In `app.js`, on line 24 you can see there's a commented out conditional if you'd like to only tweet out sales above a certain amount of Eth.

As mentioned at the top of the README, it runs every 60 seconds by default - you can change this to run less often if you'd like to keep it on a free Heroku instance.

## License 📃

This code is licensed under the [ISC License](https://choosealicense.com/licenses/isc/).

Please include proper attribution to my original repo if you fork, modify or utilize this repo in any way. Thank you!