Import a trading account with an import key
Redeem a one-time import key (serial-key style, HP-XXXXX-XXXXX-XXXXX) to link a prop-firm trading account to the logged-in user.
Prop firms create accounts without a trader attached and hand the key to their customer (order email, member area). Entering the key here — the app exposes it under Trading Accounts → Import — links the account atomically. A key can only ever be redeemed once; the firm is notified via an account.imported webhook with your email and the redemption timestamp.
Soulbound identities: every account carries the firm’s customer ID (customerId), and each firm customer is pinned to one Hyperprop login. If this customer is already bound to a DIFFERENT Hyperprop login (from an earlier import or a directly-linked account), redemption is refused with 409 TRADER_ALREADY_BOUND and a masked hint of the correct login. Sign in with that login, or ask the firm’s support to rebind your profile to your new login (note: rebinding fails all still-active accounts on the old login).
Check before redeeming: clients should call GET /trading-accounts/import/preview first — it returns what the key unlocks plus a keyStatus that surfaces soulbound conflicts (with the masked email) BEFORE the redeem. Both Hyperprop surfaces do this: the manual Import Key dialog (Trading Accounts → Import) and the auto-connect page (/connect?key=...).
Error codes: INVALID_IMPORT_KEY (404 — no such key), IMPORT_KEY_USED (409 — already redeemed), TRADER_ALREADY_BOUND (409 — firm profile bound to another Hyperprop login).
Body
One-time import key issued by the prop firm when the account was created. Case-insensitive.
6 - 64"HP-7K3QF-9XT2M-4WHRD"
Related topics
Preview an import key (no redemption)Bulk-create unlinked accounts with import keysImport demo accountUnlink a trader (issues a fresh import key)Sign up a new user