{"id":18639093,"url":"https://github.com/zseta/nftport-demo","last_synced_at":"2025-08-26T19:21:08.253Z","repository":{"id":109653083,"uuid":"561101185","full_name":"zseta/nftport-demo","owner":"zseta","description":null,"archived":false,"fork":false,"pushed_at":"2022-11-07T15:18:04.000Z","size":388,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-17T14:41:33.088Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zseta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-03T00:20:46.000Z","updated_at":"2022-11-06T17:05:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"b96cfb32-d493-4d7e-ae89-75a25f8c7d58","html_url":"https://github.com/zseta/nftport-demo","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zseta/nftport-demo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zseta%2Fnftport-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zseta%2Fnftport-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zseta%2Fnftport-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zseta%2Fnftport-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zseta","download_url":"https://codeload.github.com/zseta/nftport-demo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zseta%2Fnftport-demo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272248522,"owners_count":24899809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-26T02:00:07.904Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T05:45:01.824Z","updated_at":"2025-08-26T19:21:08.164Z","avatar_url":"https://github.com/zseta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NFT sales dashboard - Powered by NFTPort\n![](screenshots/screen1.png)\n\nThe app is available on Streamlit Cloud: https://zseta-nftport-demo-app-v7lcml.streamlit.app/\n\n## Prerequisites\n* Python 3\n* [Virtualenv](https://virtualenv.pypa.io/en/latest/)\n* NFTPort API key - [sign up here for free][sign-up]\n\n## Run the app locally\n1.  Clone the repository:\n    ```bash\n    git clone https://github.com/zseta/nftport-demo\n    cd  nftport-demo\n    ```\n1.  Create a new virtual environment, activate it and install the requirements:\n    ```bash\n    virtualenv env \u0026\u0026 source env/bin/activate\n    pip install -r requirements.txt\n    ```\n    This will install Streamlit, Plotly, requests, and all of their dependencies\n1. Open the streamlit secrets file and add your NFTPort API key\n    ```bash\n\tnano .streamlit/secrets.toml\n    [NFTPORT]\n    APIKEY = \"YOUR-API-KEY-HERE\"\n\t```\n1. Run the app:\n    ```bash\n\tstreamlit run app.py\n\t```\n\n## How to use the app\nThe app lets you analyze sale transactions made by a specific account on the\nEthereum blockchain.\n\n1. Provide an account/wallet address.\n\n    You can either choose an address from the dropdown list, as an example, or you can provide a custom ETH address that you want to analyze.\n1. The dashboard automatically updates once you hit enter.\n\n### Dashboard\n**High-level metrics**\n\n* Number of transactions\n* Average sale price\n* Lowest sale price\n* Highest sale price\n\n**Marketplace breakdown**\n\nThis column chart shows how many of the sale transactions happened on each\nmarketplace. If there's only one marketplace that was used for the transactions\nthen only one column will be displayed (e.g. opensea).\n\n**Most recently sold NFT**\n\nThis block shows details about the NFT that was most recently sold using the\ngiven address. You can also analyze the transaction further by clicking on the\nblockchain explorer link. Right next to this block, the app also displays the\nimage of the NFT.\n\n**Most recent transactions**\n\nThis table displays the five most recent sale transactions of the given address\nand provides more details about them like `date`, `marketplace`,\n`price_currency`, `price_value`, `quantity`, `hash`.\n\n**Sales volume \u0026 count**\n\nThis section displays two time-series charts of the sales volume (in ETH) and\nsales count (number of sale transactions) that this address historically.\nBelow the charts, you can also see the raw data that was used to generate the\ncharts.\n\n## Powered by NFTPort\nAll the data points displayed on the dashboard are provided by [NFTPort](https://www.nftport.xyz/).\nMore specifically, the dashboard uses the following NFTPort API endpoints:\n* [/transactions/accounts/](https://docs.nftport.xyz/docs/nftport/b3A6MzAxNDQ3NzQ-retrieve-transactions-by-an-account)\n* [/nfts/](https://docs.nftport.xyz/docs/nftport/b3A6MjAzNDUzNTM-retrieve-nft-details)\n\nNFTPort provides simple REST APIs to fetch, mint or even search NFTs. There's a\nfree tier available that you can use to [try the API][sign-up].\n\n\n[sign-up]: https://dashboard.nftport.xyz/sign-up\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzseta%2Fnftport-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzseta%2Fnftport-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzseta%2Fnftport-demo/lists"}