Overview

The Timescale NFT Starter Kit is a comprehensive guide that helps users collect, store, analyze, and visualize NFT (Non-Fungible Token) data from OpenSea. It utilizes PostgreSQL and TimescaleDB to provide a solid foundation for analyzing NFT trends and making data-driven purchasing decisions.

Features

Design database schema: Provides a relational schema for storing NFT sales, assets, collections, and accounts.
Get data: Includes an ingestion script for collecting historical data from OpenSea and ingesting it into TimescaleDB. Sample data is also available for quick start.
Build dashboards: Offers a Streamlit dashboard for analyzing collection sales and a Grafana dashboard template file for storing and analyzing NFTs.
Analyze data: Provides sample queries to serve as starting points for custom analysis.

Setting up the pre-built Superset dashboards

Ensure you have Docker and Docker compose installed.
Clone the repository.
Open a terminal and navigate to the /pre-built-dashboards folder.
Run the command docker-compose up --build.
Wait for the process to complete.
Open your browser and go to http://0.0.0.0:8088/.
Login using the provided credentials.
Access the Databases page inside Superset at http://0.0.0.0:8088/databaseview/list/.
Check the NFT Starter Kit item in the list.
Explore the NFT dashboards: Collections dashboard (http://0.0.0.0:8088/superset/dashboard/1) and Assets dashboard (http://0.0.0.0:8088/superset/dashboard/2).

Running the data ingestion script

Make sure you have Python 3 and TimescaleDB installed, with the schema set up using the schema.sql script.
Navigate to the root folder of the project.
Create a new Python virtual environment and install the requirements.
Replace [command] with the appropriate command for your environment and execute it:

[command] -m venv nft-env
source nft-env/bin/activate
pip install -r requirements.txt

Run the data ingestion script using the appropriate command for your environment.

Summary

The Timescale NFT Starter Kit is a comprehensive resource for analyzing and visualizing NFT data from OpenSea. It provides various components, including a database schema, data ingestion script, sample data, dashboards, and sample queries. The installation process involves setting up the pre-built Superset dashboards using Docker and running the data ingestion script. Users can utilize this kit to gain insights into NFT trends and make informed purchasing decisions.

Timescale

Nft Starter Kit