Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chillerno1/discord-nft-satellite

Display the floor price of an NFT collection in your Discord servers.
https://github.com/chillerno1/discord-nft-satellite

cryptocurrency discord discord-bot floorprice nft opensea python

Last synced: about 19 hours ago
JSON representation

Display the floor price of an NFT collection in your Discord servers.

Awesome Lists containing this project

README

        

# Discord NFT Satellite

Simple script to run a Discord bot that displays the floor price of an NFT collection on OpenSea.

![](assets/nft-satellite.png)

## Requirements
- [Discord Bot & Token](https://www.writebots.com/discord-bot-token/)
- Python >= 3.8

## Permissions
Invite the bot into your Discord server and ensure it has a role with the following permissions:
- View Channels
- Change Nickname

## Setup

1. Clone the repository: `git clone https://github.com/chillerno1/discord-nft-satellite`
2. cd into directory: `cd discord-nft-satellite`
3. Setup a virtual environment: `python -m venv venv`
4. Activate the virtual environment: `venv\Scripts\activate`
5. Install dependencies: `pip install -r requirements.txt`

## Usage

1. Get the slug of a collection you wish to display (**slug** is a human readable identifier that is used to identify a collection. It can be extracted from the URL: https://opensea.io/collection/{slug})
2. Append the slug to this URL to get the collection API endpoint: https://api.opensea.io/collection/{slug} (example: https://api.opensea.io/collection/boredapeyachtclub)
3. Run the following command:

```shell
usage: satellite.py [-h] --discord-token DISCORD_TOKEN --alias ALIAS --url URL

Bot to display the NFT floor price of a collection on OpenSea.
--------------------------------------------------------------

required arguments:
-t, --discord-token token for this Discord bot.
-a, --alias alias for the NFT collection to display (shown in Discord activity).
-u, --url opensea api endpoint of the collection to display.

optional arguments:
-h, --help show this help message and exit
```

### Example
```
python .\satellite.py -t AAAAAAAA.aaa.AAAA -a BAYC -u https://api.opensea.io/collection/boredapeyachtclub
```