AlphaTrack OS Eligibility Checker

Thin local client for OpenSea drop/presale eligibility.

Private keys never leave your computer. Signing happens locally. AlphaTrack only receives an auth token, wallet addresses, and SIWE signatures needed to check eligibility.

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

Create wallets.txt — one private key per line. Lines starting with # are group labels (shown in the summary next to eligible wallets). Keys never leave your computer.

# main
0xabc1111111111111111111111111111111111111111111111111111111111111

# burner1
0xabc2222222222222222222222222222222222222222222222222222222222222
0xabc3333333333333333333333333333333333333333333333333333333333333

# burner2
0xabc4444444444444444444444444444444444444444444444444444444444444

# account1
0xabc5555555555555555555555555555555555555555555555555555555555555

Replace the 0x… values with your real private keys. You can use any group names you like (main, burner1, farm, etc.). Keys under a # label belong to that group until the next # line.

Run

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

What is sent to AlphaTrack

Staging / local API

ALPHATRACK_API_BASE=http://localhost:8888