Create Key
Generate a new API key.
The raw key is returned ONCE in the response. Only the SHA-256 hash is stored in the database.
Closed-beta gating (CLOSED_BETA_MODE=true, emergency close
switch; default is off / open beta): only users who already
hold an ACTIVE admin-issued key — i.e. cohort members admitted via
POST /admin/api-keys/issue or /admin/api-keys/issue-beta —
can self-service additional keys. Admins themselves bypass the
gate. A waitlisted user with no key yet receives a 403 CLOSED_BETA
envelope pointing at the apply URL.
Authorizations
Issue from /v1/keys (or admin-issued for enterprise tier).
Headers
Body
Magic number (0..9223372036854775807) stamped on every order placed with this key that does not send its own magic. Give each bot its own key to tag its orders without code changes.
0 <= x <= 9223372036854776000Bot label (max 32 printable characters) stamped on every order placed with this key that does not send its own magic_label.
32Human-readable label
100Rate limit tier: free, pro, pro_plus, enterprise. Defaults to the tier your subscription or grant entitles you to. May be set lower than your entitlement; higher is refused.
Permissions: read, trade, admin
Response
Successful Response
Returned once on creation — the raw key is NOT stored.
Magic number (0..9223372036854775807) stamped on every order placed with this key that does not send its own magic. Give each bot its own key to tag its orders without code changes.
Bot label (max 32 printable characters) stamped on every order placed with this key that does not send its own magic_label.