v2
latestOpenAPI 3.1.02026-07-2619094236.4 KBUsers
Login
Exchange credentials for a JWT.
Supports two authentication methods:
- Fingerprint: {"fingerprint": "your-fingerprint"}
- 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"}