Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/cawfree/opensea-floor-looks-rare

🧸 💸 Determine the rarity of floor NFTs on OpenSea.
https://github.com/cawfree/opensea-floor-looks-rare

erc1155 erc721 ethereum nft non-fungible opensea

Last synced: 11 days ago
JSON representation

🧸 💸 Determine the rarity of floor NFTs on OpenSea.

Host: GitHub
URL: https://github.com/cawfree/opensea-floor-looks-rare
Owner: cawfree
License: mit
Created: 2021-12-16T17:18:23.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2022-03-27T04:51:57.000Z (over 2 years ago)
Last Synced: 2024-10-31T19:50:03.784Z (16 days ago)
Topics: erc1155, erc721, ethereum, nft, non-fungible, opensea
Language: JavaScript
Homepage:
Size: 41 KB
Stars: 39
Watchers: 3
Forks: 6
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# opensea-floor-looks-rare

## 📚 How it works! [(video)](https://twitter.com/cawfree/status/1471599400187273223)

This project depends on [__Puppeteer__](https://github.com/puppeteer/puppeteer) to programmatically scrape [__OpenSea__](https://opensea.io/) and [__rarity.tools__](https://rarity.tools/) for data, since it's not directly available using an API.

`opensea-floor-looks-rare` browses a specified NFT collection on OpenSea (ordered by `BUY_NOW`, `PRICE_ASCENDING`, i.e. sorts by the cheapest available to purchase), and parses the webpage for the currently available floor prices. Once collected, it combines the collected information with rarity data sourced by rarity tools.

This means you'll need to have a [__Chromium Browser__](https://www.chromium.org/) installed and `opensea-floor-looks-rare` will try to programmatically automate a browser window in the background.

## 🚀 Usage!

To invoke, use `npx opensea-floor-looks-rare`:

```sh
npx opensea-floor-looks-rare executable_path="/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome" --collection_slug="rumble-kong-league" --number_of_steps=5
```

You may specify a `collection_slug` to control which collection of NFTs to search for, and a `number_of_steps` to roughly control how many NFTs on the OpenSea floor are processed.

With no parameters specified, it'll default to `--collection_slug=boredapeyachtclub --number_of_steps=15`.

Once finished, you'll be presented with a table of the calculated rarities. You'll be surprised by the variation!

```
┌──────────┬────────┬──────────────────────────┐
│ Token ID │ Price │ Ranking on rarity.tools™ │
├──────────┼────────┼──────────────────────────┤
│ #1413 │ 48.84Ξ │ #6607 │
│ #1715 │ 52.4Ξ │ #9695 │
│ #3003 │ 53Ξ │ #7571 │
│ #3041 │ 50.53Ξ │ #8938 │
│ #3583 │ 51Ξ │ #9705 │
│ #4093 │ 52.5Ξ │ #6985 │
└──────────┴────────┴──────────────────────────┘
```

You can also define a `--reference_collection_slug` if you wish to compare floor tokens of one collection using the rarity of another. This is useful for collections like [__World of Women Galaxy__](https://opensea.io/collection/world-of-women-galaxy), whose attributes in the initial 10,000 would carry over some attributes from [__World of Women__](https://opensea.io/collection/world-of-women):

```sh
npx opensea-floor-looks-rare --collection_slug="world-of-women-galaxy" --reference_collection_slug="world-of-women-nft" --number_of_steps=20
```

## ✌️ License!
[__MIT__](./LICENSE.md)