dsgriffin / opensea-sales-twitter-bot Goto Github PK

View Code? Open in Web Editor NEW

196.0 10.0 298.0 64 KB

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

License: ISC License

JavaScript 99.62% Procfile 0.38%

opensea nft web3 twitter-bot ethereum

opensea-sales-twitter-bot's Introduction

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 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 (with Elevated Access, as we need v1.1 endpoint access)
A OpenSea API Key (request one here)
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)
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 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 if unsure how).

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

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

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

opensea-sales-twitter-bot's People

Contributors

Stargazers

Watchers

Forkers

punkbabybot seanbowles1 jamesondh ericpuff codermatthiasgsm srnartgallery generativeshit wolfcryptogroup wyatt0 phdemotions domhofmann kdknft fedelagarmilla mecryptocookie kurigohan004 dtruitt97 agcsu21 ubersyd claypunks bootylik projectpunks mfpooma 0x-icy ubersyd1 robertdeniro6969 fsjuhl mattwelter oakwoodgates cryptoasti cantownthisnft comrad-pete jahvi noanc loogle18 p-real96 emrecolako kurtoshi leechunhao2000 pentadotddot cryptostylenft charlieoliver rashm1n crazyrabbitltc jshaust derekcoleman jap-source strawberrywtf colliepixels h0psing gayfrog ataberkgenc hyongnimnuna 0xslot 0xntive tek19 kodbilenadam etherpebble bottybetty liowalex thefieldprojects bensch97 imuzz folia-app krzta palevoo oatmilks earlit sypr3me technocacti marcoboxhouse kwliang1 azamz dasbrod jedinrk sascha5 mr-suzuki drewmrodriguez adityaharist gh0stmustard kasunkv njpeterson17 jlhrva almuth2 hexnano drewtunney natetrillo alexbonafont spacegods edlusive varingon lukezsmith thetilekiln itsmeriley toxxer wildmouse memereversion qaqaqaqaqaqaqaqa bigfanxx asierbayon yenargy

opensea-sales-twitter-bot's Issues

occured_after no longer a valid query param | broken API request

Apparently brokensea deprecates their api query params without warning. Fun!

https://github.com/dsgriffin/opensea-sales-twitter-bot/blob/master/app.js#L54

No Issue - Thanks!

https://etherscan.io/tx/0x02abd8e68db2e82113631ecb27a62468dee07f745b1a8d95374cc1011ffe120f

Feel free to close. Just wanted you to be aware. Hope this also helps other people choose to donate if they use the code too.

1 s

Bot does not post private listings

Is there a setting I can change in the bot to also include private listings in sales to twitter?

Infinite loop on events due to inacurracy between seconds and miliseconds ?

My bot has been stuck reposting the same event over and over.
From my investigation, I'm surprised the problem didn't seem to emerge earlier and I don't totally get it.

curl 'https://api.opensea.io/api/v1/events?collection_slug=cryptocubes&occurred_after=1645787316' -H 'Accept: application/json' -H "X-API-KEY: $API_KEY" | jq '.asset_events[-1]'

Result

{
  "approved_account": null,
  "asset": {
    "id": 17168260,
    "num_sales": 3,
    "background_color": null,
    "image_url": "https://lh3.googleusercontent.com/1juN1Mbi52rVbspQtDG9-Ichs8_WdCH2L6gwx3yFlpv-PKfETMZ8haemFX8veXul31wwLb_ScwxIN0RkDUPF8gMmKQ",
    "image_preview_url": "https://lh3.googleusercontent.com/1juN1Mbi52rVbspQtDG9-Ichs8_WdCH2L6gwx3yFlpv-PKfETMZ8haemFX8veXul31wwLb_ScwxIN0RkDUPF8gMmKQ=s250",
    "image_thumbnail_url": "https://lh3.googleusercontent.com/1juN1Mbi52rVbspQtDG9-Ichs8_WdCH2L6gwx3yFlpv-PKfETMZ8haemFX8veXul31wwLb_ScwxIN0RkDUPF8gMmKQ=s128",
    "image_original_url": "https://ipfs.io/ipfs/QmQQPBFQ221xKcMo31k4pKbEwQwHAZugV2qHjWhdGZ47c8/image.gif",
    "animation_url": null,
    "animation_original_url": null,
    "name": "CryptoCube#136",
    "description": "Join the punk movement.  \n\nExhibit your CryptoCube in 3d platforms.",
    "external_link": "https://app.rarible.com/token/0xdbb163b22e839a26d2a5011841cb4430019020f9:152",
    "asset_contract": {
      "address": "0xdbb163b22e839a26d2a5011841cb4430019020f9",
      "asset_contract_type": "non-fungible",
      "created_date": "2020-10-04T16:51:37.658205",
      "name": "CryptoCubes",
      "nft_version": "3.0",
      "opensea_version": null,
      "owner": 12077606,
      "schema_name": "ERC721",
      "symbol": "CC",
      "total_supply": "0",
      "description": "CryptoCubes are algorithmically generated metaverse-native 3d NFT collectibles.\r\n\r\nLimited to 256\r\n\r\nCreated by Han.",
      "external_link": "https://app.rarible.com/collection/0xdbb163b22e839a26d2a5011841cb4430019020f9",
      "image_url": "https://lh3.googleusercontent.com/X_V_EbYK5XpjO_j1AETDTUkolFCx-HJzcpM5TtMbI3bVN1ny4wVvXcX_BYzcAkzbTHjtW0mgGNmqOSRiejhr3tPt=s120",
      "default_to_fiat": false,
      "dev_buyer_fee_basis_points": 0,
      "dev_seller_fee_basis_points": 1000,
      "only_proxied_transfers": false,
      "opensea_buyer_fee_basis_points": 0,
      "opensea_seller_fee_basis_points": 250,
      "buyer_fee_basis_points": 0,
      "seller_fee_basis_points": 1250,
      "payout_address": "0xbf28421a82186bf50f496ab937c3368b55adbf19"
    },
    "permalink": "https://opensea.io/assets/0xdbb163b22e839a26d2a5011841cb4430019020f9/152",
    "collection": {
      "banner_image_url": "https://lh3.googleusercontent.com/eMwxxLlB7W8Psnr61OLliEFQlA8Bt5Y4tz1KXiEZaDD83t4IxIJcQMIZfm9ClVr5ATBOZxSLKcuGhtV_kdl4dVcs=s2500",
      "chat_url": null,
      "created_date": "2020-10-20T19:31:14.007197",
      "default_to_fiat": false,
      "description": "CryptoCubes are algorithmically generated metaverse-native 3d NFT collectibles.\r\n\r\nLimited to 256\r\n\r\nCreated by Han.",
      "dev_buyer_fee_basis_points": "0",
      "dev_seller_fee_basis_points": "1000",
      "discord_url": "https://discord.gg/cryptocubes",
      "display_data": {
        "card_display_style": "contain"
      },
      "external_url": "https://app.rarible.com/collection/0xdbb163b22e839a26d2a5011841cb4430019020f9",
      "featured": false,
      "featured_image_url": null,
      "hidden": false,
      "safelist_request_status": "verified",
      "image_url": "https://lh3.googleusercontent.com/X_V_EbYK5XpjO_j1AETDTUkolFCx-HJzcpM5TtMbI3bVN1ny4wVvXcX_BYzcAkzbTHjtW0mgGNmqOSRiejhr3tPt=s120",
      "is_subject_to_whitelist": false,
      "large_image_url": "https://lh3.googleusercontent.com/X_V_EbYK5XpjO_j1AETDTUkolFCx-HJzcpM5TtMbI3bVN1ny4wVvXcX_BYzcAkzbTHjtW0mgGNmqOSRiejhr3tPt",
      "medium_username": null,
      "name": "CryptoCubes",
      "only_proxied_transfers": false,
      "opensea_buyer_fee_basis_points": "0",
      "opensea_seller_fee_basis_points": "250",
      "payout_address": "0xbf28421a82186bf50f496ab937c3368b55adbf19",
      "require_email": false,
      "short_description": null,
      "slug": "cryptocubes",
      "telegram_url": null,
      "twitter_username": "CubesCrypto",
      "instagram_username": null,
      "wiki_url": null
    },
    "decimals": 0,
    "token_metadata": "https://ipfs.io/ipfs/QmaMDuYvnNU9HcLKXm419Lu3KafRPt56kccj7xmtHJiRtU",
    "owner": {
      "user": {
        "username": "Futureis"
      },
      "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/23.png",
      "address": "0x1fdc7ec0a099dadf4643faea7cd0fcee23075932",
      "config": ""
    },
    "token_id": "152"
  },
  "asset_bundle": null,
  "auction_type": null,
  "bid_amount": "10000000000000000000",
  "collection_slug": "cryptocubes",
  "contract_address": "0x7f268357a8c2552623316e2562d90e642bb538e5",
  "created_date": "2022-02-25T11:08:36.706701",
  "custom_event_name": null,
  "dev_fee_payment_event": null,
  "dev_seller_fee_basis_points": 1000,
  "duration": null,
  "ending_price": null,
  "event_type": "offer_entered",
  "from_account": {
    "user": {
      "username": "M4T"
    },
    "profile_img_url": "https://storage.googleapis.com/opensea-static/opensea-profile/15.png",
    "address": "0x6bf97f2534be2242ddb3a29bfb24d498212dcded",
    "config": ""
  },
  "id": 3676682692,
  "is_private": null,
  "owner_account": null,
  "payment_token": {
    "id": 2,
    "symbol": "WETH",
    "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "image_url": "https://storage.opensea.io/files/accae6b6fb3888cbff27a013729c22dc.svg",
    "name": "Wrapped Ether",
    "decimals": 18,
    "eth_price": "1.000000000000000",
    "usd_price": "2630.679999999999836000"
  },
  "quantity": "1",
  "seller": null,
  "starting_price": null,
  "to_account": null,
  "total_price": null,
  "transaction": null,
  "winner_account": null,
  "listing_time": null
}

The returned event created_date is 2022-02-25T11:08:36.706701
Now if we make a moment out of it, we get

> const moment = require('moment');
> moment("2022-02-25T11:08:36.706701").unix()
1645787316

The resulting request will be https://api.opensea.io/api/v1/events?collection_slug=cryptocubes&occurred_after=1645787316 again, and that will fetch and post the same event again. Just incrementing the timestamp by 1 will prevent the problem to happen (but we might miss some events !)

Am I the only one experiencing the problem ? Was occured_after exclusive of timestamp and became inclusive ?

Pull from multiple OpenSea collection slugs?

Howdy,

With the current code base, what's the quickest change that I could make to allow the API to pull from 2 (or possibly more) collection_slug?

Thanks!

Why is X_API_KEY now mandatory

Hey, love the bot - has been running really well.

Recently stopped working and I noticed the code changes that now require an OS API key?

I have fetched the new updates and applied for an API key, however, the doco says that the key is not mandatory?

Not sure if the OpenSea doco has not been updated or if it’s just the way the bot uses the API?

lastSaleTime: undefined

re: https://github.com/KadeStroude/immutable-x-marketplace-sales-twitter-bot (a fork of your code!)

Hi @dsgriffin, or anyone else - would you mind please assisting me with this?

I am not super familiar with some of the libraries you have used, however made a few changes to the section of 'app.js' where you pull data from OpenSea every 60 seconds:

Changed the moment(). units to 'toISOOString().' (from 'unix().' - as that is incompatible with the Immutable X API)
Changed the API url to Immutable X's API (from OpenSea)
Changed the params such that they were relevant to the new API

I then tried to make some ammendments to the events / response section and the outcome has been my lastSaleTime variable is consistently 'undefined'. Do you know where I am going wrong please?

https://docs.x.immutable.com/reference/get_v1-applications-1

Why I am getting this error

2021-11-24T10:24:07.827195+00:00 app[worker.1]: [Symbol(kCapture)]: false,
2021-11-24T10:24:07.827195+00:00 app[worker.1]: [Symbol(kNeedDrain)]: false,
2021-11-24T10:24:07.827195+00:00 app[worker.1]: [Symbol(corked)]: 0,
2021-11-24T10:24:07.827196+00:00 app[worker.1]: [Symbol(kOutHeaders)]: [Object: null prototype]
2021-11-24T10:24:07.827196+00:00 app[worker.1]: },
2021-11-24T10:24:07.827196+00:00 app[worker.1]: data: 'error code: 1020'
2021-11-24T10:24:07.827196+00:00 app[worker.1]: },
2021-11-24T10:24:07.827196+00:00 app[worker.1]: isAxiosError: true,
2021-11-24T10:24:07.827197+00:00 app[worker.1]: toJSON: [Function: toJSON]
2021-11-24T10:24:07.827197+00:00 app[worker.1]: }

Last sale (in seconds since Unix epoch): undefined

hi griffin,

first off, thanks for setting this up. i have one question about increasing the interval.

2021-09-02T06:37:33.825569+00:00 app[worker.1]: Last sale (in seconds since Unix epoch): undefined

I changed the interval from 60000 to 120000 at line 81 in app.js. is that how this should be done?

Last sale (in seconds since Unix epoch): undefined

Anyone else have the issue of the bot suddenly stop posting tweet of sales only message seen in logs every 1-2 mins
Last sale (in seconds since Unix epoch): undefined

update: twitter seems to suspend accounts thinking its spam

The bot misses some sales

Sometimes the bot misses sales