v2

latestOpenAPI 3.1.02026-07-2619094236.4 KB
Users

Login

Exchange credentials for a JWT.

Supports two authentication methods:

  1. Fingerprint: {"fingerprint": "your-fingerprint"}
  2. Hotkey signature: {"hotkey": "5...", "signature": "hex...", "nonce": "uuid"}

For hotkey auth, first call GET /users/login/nonce to get a nonce, sign it with your hotkey (e.g., btcli w sign --message <nonce>), then submit the hotkey, signature, and nonce.

post/users/login

Response

Successful Response

{"stackTrail":"paths:/users/login:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}