AlphaTrack OS Eligibility Checker

Thin local client for OpenSea drop/presale eligibility.

Private keys are never stored as plaintext. You import each key once into an encrypted keystore (password-protected, same idea as MetaMask/geth). Signing happens on your machine; AlphaTrack only receives an auth token, wallet addresses, and SIWE signatures.

Prefer burner wallets with no (or minimal) funds for this tool.

Install

Use a virtual environment (pick one), then install the package.

Option A — venv (built into Python, no conda needed):

# If .venv already exists from an older folder name, remove it first:
# rm -rf .venv

python3 -m venv .venv
source .venv/bin/activate          # macOS / Linux
# .venv\Scripts\activate           # Windows
pip install alphatrack-os-eligibility-checker

Option B — conda:

conda create -n alphatrack-os-eligibility python=3.11 -y
conda activate alphatrack-os-eligibility
pip install alphatrack-os-eligibility-checker

Dependencies (requests, eth-account, python-dotenv, tqdm) install automatically with the package.

Setup

1. Create a free AlphaTrack account
2. Open Dashboard → OS Eligibility Checker → Generate token → copy it
3. In a working folder:

mkdir my-os-eligibility-check && cd my-os-eligibility-check

Create .env:

ALPHATRACK_TOKEN=at_your_token_here
# ALCHEMY_API_KEY=optional_for_balances
# ALPHATRACK_KEYSTORE_PASSWORD=optional_for_noninteractive_runs

Import wallets (encrypted)

Import each key once. Input is hidden; the key is encrypted to ./keystores/ and never written as plaintext.

alphatrack-os-eligibility-checker import-wallet --label main
alphatrack-os-eligibility-checker import-wallet --label burner1
alphatrack-os-eligibility-checker import-wallet --label burner2
alphatrack-os-eligibility-checker list-wallets

Use a burner / delegate wallet when you can — not your primary cold wallet.

Run

You will be prompted for the keystore password (or set ALPHATRACK_KEYSTORE_PASSWORD for automation).

alphatrack-os-eligibility-checker check -c todd-nft
# or
alphatrack-os-eligibility-checker check -c https://opensea.io/collection/todd-nft/overview

What is sent to AlphaTrack

Staging / local API

ALPHATRACK_API_BASE=http://localhost:8888