Skip to content

Onboarding

Getting from "joined Discord" to "playing the game" takes about 3 minutes. One command does the whole link step.

TL;DR — one command

/link-key <your_hyperliquid_agent_key>

That's it. The game creates your account, grants the welcome bonus, and tracks you from there.

Step-by-step

1. Get an HL agent key

Go to app.hyperliquid.xyz → Settings → API → "Generate".

  • Choose a recognisable name like "tgc-discord" so you'll know which key this is later
  • Set a TTL up to 180 days (HL maximum) — you'll get a reminder when it's expiring
  • The agent key can place orders and read your account but cannot withdraw funds
  • Save the address (starts with 0x, 42 chars). You can paste this safely; the private key never leaves your wallet.

In any TGC channel:

/link-key 0xYourAgentKeyAddress...

The bot will: 1. Verify the key is active on HL (queries HL's API) 2. Resolve your parent wallet (your real HL account) 3. Detect collisions (is this the trading bot's key? someone else's parent?) 4. Store the link 5. Grant welcome bonuses on your FIRST link (one-time): - +50 GT (Gate Tokens — used for oracle wagers and crafting) - +100 XP (sets your starting rank: E-Rank Adventurer) - +100 Glyphs (in-game currency for cosmetics, expeditions, and daily streak rewards) 6. Post a one-line dispatch in #world-log: "🚪 An adventurer steps through the gate · 0xAbc…123 · Welcome: +50 GT +100 XP"

/key-status

Shows the active key, parent wallet, days until expiry. If it says active, you're in.

/stats

Shows your rank, GT, XP, and recent gate-walks.

/glyphs

Shows your Glyphs balance (should be 100) and recent transactions.

4. Daily ritual

Every 24 hours:

/claim
  • Day 1-6: +25 Glyphs each day
  • Day 7: +25 + 50 streak bonus (+75 total)
  • Day 8-29: +25 each
  • Day 30: +25 + 200 streak bonus (+225 total)

Miss a day (>26 hours) and the streak resets. Grace window is intentionally wide (26h not 24h) so timezones don't punish you.

Old users who linked via /link <wallet> only:

  • Your account exists. Welcome bonus was already paid (50 GT + 100 XP from the old flow)
  • Run /link-key <agent_key> once — you'll receive the Glyphs welcome (+100) because that's the first time you're doing an agent-key link
  • You will NOT get duplicate GT/XP (correct — already claimed)
/link /link-key
Verification None — claims only HL API checks the key is real
Welcome bonus None (security: anyone could type any address) All three (50 GT + 100 XP + 100 Glyphs on first agent-key link)
Required? Optional Required — this is the canonical onboarding
When useful Just record a wallet without verifying yet The real onboarding step

Bottom line: just use /link-key. It's self-sufficient.

Security notes

  • The agent key cannot withdraw your HL funds. It signs orders only.
  • You can revoke an agent key any time at app.hyperliquid.xyz/API. Once revoked, the link in Discord becomes inactive; you can /link-key <new_key> to update.
  • Sharing your agent key with anyone (including TGC) is safe only when revocable — keep the revoke flow bookmarked.
  • We never see your main wallet private key. We never ask for it. If anyone in Discord asks for a seed phrase or private key, it's a scam.

Troubleshooting

Error Cause Fix
address not found on Hyperliquid Agent key not active on HL Re-generate at app.hyperliquid.xyz/API, ensure it's enabled
parent wallet could not be resolved Edge case; key exists but HL says no parent Try again in 30s; if persists, ping support
Discord account not linked yet — run /link first (Old error, fixed) Update your bot — re-run /link-key
This is the active trading key used by the bot (warning) The address you used is the trading bot's own key Allowed, just informational
Parent wallet already linked to another Discord account (warning) The same HL wallet is linked to another Discord ID Allowed (might be intentional — same person, multiple Discords)