List API Keys

Returns all API keys on your account with their names, permissions, and creation dates. Secret key values are never returned by this endpoint.

GET/api/v1/keysRequires authentication

No secrets returned

This endpoint does not return the key or secret fields. API key secrets are only shown once at creation time via POST /keys.

Request

No query parameters or request body. Requires a valid JWT or API key.

Request examples

curl https://merx.exchange/api/v1/keys \
  -H "X-API-Key: sk_live_your_key_here"

Response

Returns an array of key objects. Each object includes the key identifier, name, permissions, and timestamps but never the secret.

200Success

[
  {
    "id": "key_m1n2o3p4",
    "name": "Production Bot",
    "permissions": ["create_orders", "view_orders", "view_balance"],
    "created_at": "2026-03-29T10:00:00.000Z",
    "last_used_at": "2026-03-29T14:22:00.000Z"
  },
  {
    "id": "key_q5r6s7t8",
    "name": "Read-only Monitor",
    "permissions": ["view_orders", "view_balance"],
    "created_at": "2026-03-20T08:00:00.000Z",
    "last_used_at": null
  }
]

Response fields

idstringUnique key identifier

namestringLabel assigned to this key

permissionsstring[]Granted permission scopes

created_atstringISO 8601 creation timestamp

last_used_atstring | nullISO 8601 timestamp of last use, or null