nft-market
What is it?
nft-market is a Python library by which current market information of NFTs on several famous NFT markets (OpenSea, Magic Eden, tofuNFT, PancakeSwap, etc) can be obtained.
Main features
nft-market provides simple APIs that return market information just by your giving the following arguments.
- The marketplace (from
nft_market.Market) - the ID of a specific NFT (See the below in detail)
from nft_market import Market, Retriever
r = Retriever()
print(r.fetch(Market.OpenSea, 'boredapeyachtclub')) # Bored Ape Yacht Club
# [Output]
# type: nft_market.NFTInfo
# NFTInfo(id='boredapeyachtclub', name='Bored Ape Yacht Club', num_supply=None, num_listing=10000, num_owners=6400, floor=111.0, volume=487600.0)
Currently supported marketplaces
At this moment, the following marketplaces are supported in nft-market.
- OpenSea
- tofuNFT
- PancakeSwap
- Rarible
- GhostMarket
- Crypto.com
- Gem
- NFTrade
- Solanart
- Magic Eden
- XANALIA
- Coinbase
- Nifty Gateway
- YUMI
Other marketplaces will be added into the list in the future. You can, off course, request them in issues if needed immediately. Either PRs or issues are always welcome!
Currently supported explorers
The following explorers are supported in nft-market. If possible, using these explorers is recommended rather than using the above marketplaces, such as Enterpot, for more stability.
How to get the ID of a NFT?
Although it depends on which marketplace you use, you can basically find it in the URL.
Example 1: OpenSea
When you want to retrieve the information of the NFT of Bored Ape Yacht Club
, the URL looks like https://opensea.io/collection/boredapeyachtclub
. In this URL, what differs according to a NFT is the part of boredapeyachtclub, which is all you need to use **
nft-market**.
Example 2: tofuNFT
URLs look like https://tofunft.com/collection/astardegens/items. In this case, what nft-market requires is only
the part of astardegens.
Other examples
We have several examples of the usage in samples.py for references.
Available information
What you can retrieve may change by a marketplace you specify, as follows. Other information may be provided in the future!
| Market | Name | #Supply | #Listing | #Owners | Floor | Volume |
|---|---|---|---|---|---|---|
| OpenSea | ✓ | ✓ | ✓ | ✓ | ||
| tofuNFT | ✓ | ✓ | ✓ | ✓ | ✓ | |
| PancakeSwap | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Rarible | ✓ | ✓ | ✓ | ✓ | ✓ | |
| GhostMarket | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Crypto.com | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Gem | ✓ | ✓ | ✓ | ✓ | ||
| NFTrade | ✓ | ✓ | ✓ | |||
| Solanart | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Magic Eden | ✓ | ✓ | ✓ | ✓ | ||
| XANALIA | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Coinbase | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Nifty Gateway | ✓ | ✓ | ✓ | ✓ | ✓ | |
| YUMI | ✓ | ✓ | ✓ | ✓ | ✓ |
| Explorer | Ecosystem | Name | #Supply | #Listing | #Owners | Floor | Volume |
|---|---|---|---|---|---|---|---|
| ICScan | ICP | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| NFTgeek | ICP | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
"✓(*)" means it can return None value depending on items.
Installation
You can install nft-market by pip.
$ pip install nft-market
Also, as nft-market depends on Firefox and its driver, you need to install them.
[mac]
$ brew install firefox
[ubuntu]
$ sudo apt install firefox
Besides, all Python dependencies are listed up in requirements.txt. Please install them
by $ pip install -r requirements.txt if you install nft-market not by pip but by cloning from GitHub.
For developers
You can run tests similarly as GitHub Actions in your local environment by using ACT. We highly recommend you try this for at least what you added before push.
Installation
# mac
$ brew install act
# Linux
$ curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
# Windows Chocolatey
$ choco install act-cli
# Windows Scoop
$ scoop install act
How to use act?
Make sure that you're already running Docker Desktop, and then just run act!
$ act push --container-architecture linux/amd64
Note that when you see choices as for the default size of images, you need at least "Medium".
Default image and other options can be changed manually in ~/.actrc (please refer to https://github.com/nektos/act#configuration for additional information about file structure) [Use arrows to move, type to filter, ? for more help]
Large
> Medium
Micro
1 maintainer
Release files for nft-market 1.56
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nft_market-1.56.tar.gz | 14.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nft_market-1.56-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.6 kB
Release files / nft_market-1.56.tar.gz
| Download URL | nft_market-1.56.tar.gz |
|---|---|
| Size | 14.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
00f5dd546af8557f1ef9e6b6a63a73efb1d81245307e98fe2a6cae3b13bf0d72
|
|
BLAKE2b-256 checksum How to use checksums |
39868c66fba479965208d91afdd9c3a45b98f41a2650e87d9b868e05782b3ef0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Release files / nft_market-1.56-py3-none-any.whl
| Download URL | nft_market-1.56-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b4e428485054d4c6cd357a1a6382868e1c9616cbf0af2b096759f47696ec7b7e
|
|
BLAKE2b-256 checksum How to use checksums |
68462ba7aa4fea6d0dff278c62261ab506061fac91ae222f7d1cb8fe9e73b271
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
