Skip to main content

​
Quick Start

​
1. Get your API key

Sign up at tryhoard.com and upgrade to Pro. Your API key is shown on the settings page. Hoard settings page showing API key, sync frequency, and pricing strategy

​
2. Download the agent

Download the Hoard Agent for your platform from the setup page (auto-detects your OS).
PlatformDownload
Mac (Apple Silicon / M1–M4)hoard-agent_darwin_arm64.tar.gz
Mac (Intel)hoard-agent_darwin_amd64.tar.gz
Windowshoard-agent_windows_amd64.zip
Linuxhoard-agent_linux_amd64.tar.gz

​
3. Configure

Open the .env file included in the download and fill in your values: 
HOARD_API_KEY=your-api-key-from-dashboard
TCGPLAYER_EMAIL=your-tcgplayer-email
TCGPLAYER_PASSWORD=your-tcgplayer-password
Your TCGplayer password never leaves your computer. The agent uses it locally to log into TCGplayer in a real browser, just like you would. Hoard’s servers never see it.

​
4. Run it

# macOS flags downloads from the internet — this clears it (same as any app you download outside the App Store)
xattr -d com.apple.quarantine hoard-agent

# First run — opens a browser window so you can log in
HEADED=1 ./hoard-agent workflows/tcgplayer.yaml
A Chrome window will open to TCGplayer’s login page. Log in normally — TCGplayer uses a CAPTCHA on login, which is why the first run needs a visible browser. After this, your session is saved and future syncs run without a browser window.

​
5. Run headless

After the first login, your session is saved. Run without HEADED=1: 
./hoard-agent workflows/tcgplayer.yaml
The agent polls every 30 seconds and syncs when scheduled. Leave it running or set up a startup script.
The first sync takes 2-3 minutes. It exports your full inventory, uploads it to Hoard, and imports any price updates back to TCGplayer.
Once synced, your dashboard will look like this: Hoard Cards tab showing your full inventory with pricing, market values, and profit tracking