# Your API token and scoped keys

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

Canonical page: https://propmetaapi.com/help/api-keys  
Topic: API access & keys  
Last updated: 2026-10-28

## 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

- [Authentication & keys](https://propmetaapi.com/docs/authentication)

## Related guides

- [API usage, limits and common errors](https://propmetaapi.com/help/api-usage-and-limits): Track your requests and active accounts, understand rate limits and quotas, and read the error codes you'll meet most.
- [Two-factor authentication (2FA)](https://propmetaapi.com/help/two-factor-authentication): Protect sign-in and API token access with email codes or Google Authenticator, and keep recovery codes safe.
