Package: nft-market
nft-marketWhat is it?nft-marketis 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 featuresnft-marketprovides simple APIs that return market information just by your giving the following arguments.The marketplace (fromnft_market.Market)the ID of a specific NFT (See the below in detail)fromnft_marketimportMarket,Retrieverr=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 marketplacesAt this moment, the following marketplaces are supported innft-market.OpenSeaEntrepot(depreacated)tofuNFTPancakeSwapRaribleGhostMarketCrypto.comGemNFTradeSolanartMagic EdenXANALIACetoSwap(depreacated)CoinbaseCCC(depreacated)Nifty GatewayJelly(depreacated)YUMIOther 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 explorersThe following explorers are supported innft-market.
If possible, using these explorers is recommended rather than using the above marketplaces, such as Enterpot, for more stability.ICScan(Supporting: ICP)NFTgeek(Supporting: ICP)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: OpenSeaWhen you want to retrieve the information of the NFT ofBored Ape Yacht Club, the URL looks likehttps://opensea.io/collection/boredapeyachtclub. In this URL, what differs according to a NFT is the part ofboredapeyachtclub, which is all you need to use **
nft-market**.Example 2: tofuNFTURLs look likehttps://tofunft.com/collection/astardegens/items. In this case, whatnft-marketrequires is only
the part ofastardegens.Other examplesWe have several examples of the usage insamples.pyfor
references.Available informationWhat you can retrieve may change by a marketplace you specify, as follows.
Other information may be provided in the future!MarketName#Supply#Listing#OwnersFloorVolumeOpenSea✓✓✓✓Entrepot✓✓✓✓tofuNFT✓✓✓✓✓PancakeSwap✓✓✓✓✓Rarible✓✓✓✓✓GhostMarket✓✓✓✓✓Crypto.com✓✓✓✓✓Gem✓✓✓✓NFTrade✓✓✓Solanart✓✓✓✓✓Magic Eden✓✓✓✓XANALIA✓✓✓✓✓CetoSwap✓✓✓✓✓✓Coinbase✓✓✓✓✓CCC✓✓✓✓(*)✓✓Nifty Gateway✓✓✓✓✓Jelly✓✓✓✓✓YUMI✓✓✓✓✓ExplorerEcosystemName#Supply#Listing#OwnersFloorVolumeICScanICP✓✓✓✓✓✓NFTgeekICP✓✓✓✓✓✓"✓(*)" means it can return None value depending on items.InstallationYou can installnft-marketby pip.$pipinstallnft-marketAlso, asnft-marketdepends on Firefox and its driver, you need to install them.[mac]$brewinstallfirefox[ubuntu]$sudoaptinstallfirefoxBesides, all Python dependencies are listed up inrequirements.txt. Please install them
by$ pip install -r requirements.txtif you installnft-marketnot by pip but by cloning from GitHub.For developersYou can run tests similarly as GitHub Actions in your local environment by usingACT.
We highly recommend you try this for at least what you added before push.Installation# mac$brewinstallact# Linux$curlhttps://raw.githubusercontent.com/nektos/act/master/install.sh|sudobash# Windows Chocolatey$chocoinstallact-cli# Windows Scoop$scoopinstallactHow to use act?Make sure that you're already running Docker Desktop, and then just run act!$actpush--container-architecturelinux/amd64Note that when you see choices as for the default size of images, you need at least "Medium".Defaultimageandotheroptionscanbechangedmanuallyin~/.actrc(pleaserefertohttps://github.com/nektos/act#configurationforadditionalinformationaboutfilestructure)[Usearrowstomove,typetofilter,?formorehelp]Large
>MediumMicro