API access & keys

Your API token and scoped keys

Reveal and rotate your primary token, create keys with limited permissions or accounts, and keep them safe.

  1. The primary token

    API → Token & keys shows the Primary token issued with your plan. It has every permission on all your accounts. Click Reveal & copy to see it — you confirm it's you with your password (and 2FA code) each time.

    The primary token stays the same when you renew or change plan.

  2. Create scoped keys

    Give each app or team member its own key with only what it needs. Click Create key and choose:

    • Label — for example "reporting dashboard".
    • Permissions — Read (accounts, positions, history, quotes, events and streams), Trade (place, change and close orders), Manage (accounts, keys, webhooks, billing and settings).
    • Accounts — all accounts, or only selected ones.
    • Expires on — optional; the key stops working at the end of that day (UTC).

    The new key is shown once. Copy it before closing the window. You can have up to 20 working keys.

    A read-only dashboard should never get a Trade key.

  3. Revoke a key

    Click Revoke next to a scoped key. Apps using it stop working at once, and keys it created are revoked too. Tick Show revoked and expired keys to see old keys.

  4. If a key leaks

    Act immediately:

    • a scoped key — Revoke it and create a new one;
    • the primary token — click Rotate. A new token is issued and the old one stops working at once, so update every app that uses it right away.

    Then check API usage and Events for activity you don't recognise.

  5. Keeping keys safe

    Keep keys on your server (environment variables or a secret manager), never in a website, mobile app or public repository. Never paste a full key into a ticket or chat — our team will never ask for it. The first characters after gw_ (the key prefix) are enough for us to find it.

For developers

The API side of this topic, with every field and code examples:

Still need help?

Our team answers questions about integration, plans and payments — typically within a few hours on business days.