Reference
Scopes
Reference for operator API key scopes.
Scopes
Current scope list comes from operator API key creation source.
Supported scopes
launch:writeusers:readmarkets:readtrades:readredemptions:readbalance_operations:readapi_keys:readapi_keys:writewebhooks:readwebhooks:writesimulator:readsimulator:write*
* means full operator API access.
Endpoint mapping
| Scope | Endpoints |
|---|---|
launch:write | POST /api/operator/launch |
users:read | GET /api/operator/users |
markets:read | GET /api/operator/markets |
trades:read | GET /api/operator/trades |
redemptions:read | GET /api/operator/redemptions |
balance_operations:read | GET /api/operator/balance-operations |
api_keys:read | GET /api/operator/api-keys |
api_keys:write | POST /api/operator/api-keys, POST /api/operator/api-keys/{id}/revoke |
webhooks:read | GET /api/operator/webhooks/endpoints, GET /api/operator/webhooks/deliveries |
webhooks:write | POST /api/operator/webhooks/endpoints, PATCH /api/operator/webhooks/endpoints/{id}, POST /api/operator/webhooks/deliveries/{id}/replay |
simulator:read | GET /api/operator/simulator/wallets/{externalUserId}, GET /api/operator/simulator/operations/{idempotencyKey} |
simulator:write | PUT /api/operator/simulator/wallets/{externalUserId}, POST /api/operator/simulator/operations |
Recommended key split
- server-side launch key:
launch:write - reporting key: read scopes only
- webhook admin key:
webhooks:read,webhooks:write - simulator key for staging only:
simulator:read,simulator:write
Rotation rule
Do not reuse one broad key everywhere. Split by workload and rotate independently.