A trade key lets a terminal or bot trade your account without your wallet. It places and cancels orders within the limits you set and moves no money out: Exits, deposits, Receipts, disclosures and the Escape stay yours. Trade keys sits on Account under Deposit and Exit, with the count of your keys, n of 4.
Make a key#
Press New trade key#
New trade key opens the choices. It shows while you hold fewer than four keys.
Choose what the key may do#
Trade and cancel places and cancels orders. Cancel only cancels the account’s resting orders and places none.
Set the cap#
Cap per Crossing is the most notional, in USD, the key’s orders may reach for one Crossing, valued at each order’s limit and the latest mid. Leave it blank for no cap. A Cancel only key takes no cap.
Set the expiry#
Expires after 1 day, 7 days, 30 days or 90 days. From then on the enclave refuses the key.
Press Make the key#
Make the key signs the key into your account with your account’s key, sealed to the enclave like any Intent; no wallet prompt. The panel then reads “Key id is active. Copy both now; they show only here.” with two strings to copy:
| Copy | What it is |
|---|---|
| Trade key | The key itself. Whoever holds it trades your account within its limits. |
| View | The balance keys the terminal reads your current balances with. It opens no history. |
Under them is the line a terminal connects with, Privium.connect({ apiUrl, tradeKey, view }) (Privium inside a terminal or bot). Paste both into the terminal, then press Done. Privium keeps neither: a lost key is revoked and made again.
Your keys#
Each active key is a row: its id, then what it may do, its cap and its expiry, as “Trade and cancel · $cap per Crossing · until date” or “Cancel only · No cap · until date”. Revoke ends a key at once: the enclave refuses every Intent it signs after that, and its orders already resting stay until they fill, expire or you cancel them. The list comes from the enclave and follows you to any device.
The terminal’s orders are your orders: they fill in Crossings at the same mid, and land in History and in your Receipts as any of yours do.
Integrator id#
Integrator id, under the keys, is your account’s own id for terminals: “A terminal names this id to be paid its fee into this account.” A terminal that names it, with a rate up to 1%, is paid that rate on the quote notional of every fill it places, in the quote asset, credited to this account in the fill’s own Commit (Integrator fees).
History on Account shows both sides: the trader’s fill pays a fee entry, “Fee · protocol and integrator fee”, whose amount is both fees, and the integrator’s account lists Integrator fee received. A Receipt made with the SDK can state Integrator fees paid or Integrator fees received over its span (receipt).