ruggedfish/nft-fossils — explained in plain English
Analysis updated 2026-05-18
Search for NFTs that once sold for over a certain dollar amount and are now listed cheaply on OpenSea.
Filter results by price drop ratio, sale date range, or number of distinct big sales to avoid wash-traded tokens.
Export search results as a markdown table, CSV, or JSON file for further analysis.
Build or refresh a private index of historical NFT sales data using your own API keys.
| ruggedfish/nft-fossils | 0xallam/my-recipe | 0xhassaan/nn-from-scratch | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | Python | Python | Python |
| Last pushed | — | 2022-11-22 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 2/5 | 2/5 | 4/5 |
| Audience | general | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a free OpenSea API key, building your own index instead of using the prebuilt one also needs an Alchemy API key and takes about a day.
nft-fossils is a command line tool for finding NFTs that once sold for tens or hundreds of thousands of dollars during the crypto boom and are now listed for a tiny fraction of that price. It works in two steps. First, it builds or downloads an index that records which NFT tokens had large historical sales, backed by the actual on-chain transaction as proof, so those numbers cannot be faked after the fact. Second, when you run a search, it checks OpenSea for the current listing price of those tokens, so the prices you see are always live rather than pulled from a stale database. You can filter results by minimum historical sale amount, maximum current price, how many separate big sales a token had, how far the price has dropped from its peak, and the date range of the original sale. Results can be printed as a table, or written out as a CSV or JSON file. Building a full index from scratch takes about a day and needs OpenSea and Alchemy API keys, but a prebuilt index ships with each release so most people can get results in seconds, and an update command refreshes an existing index quickly instead of rebuilding it. The README is careful about honesty limits. It only counts sales from OpenSea and Blur, not other marketplaces. It filters out bundle sales where several NFTs sold together for one price, since attributing the full amount to each token would be misleading. It only supports ERC-721 tokens, not the ERC-1155 standard, since those exist in multiple copies. The author is explicit that this is not financial advice, and that these tokens are cheap because demand for them has disappeared, not because they are secretly undervalued. The tool has no external Python dependencies and works with any Python 3.9 or newer. It is released under the MIT license.
A command line tool that finds NFTs which once sold for huge sums and are now listed cheaply, using verified on-chain sale history.
Mainly Python. The stack also includes Python.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.