Request Wallet Nonce
POST /v1/users/auth/wallet/nonce
Auth: None
| Field | Type | Required | Description |
|---|---|---|---|
address | string | Yes | EVM address, 0x + 40 hex chars |
curl -X POST https://api.2settle.io/v1/users/auth/wallet/nonce \
-H "Content-Type: application/json" \
-d '{ "address": "0xabc1234567890def1234567890abcdef12345678" }'
{
"success": true,
"data": {
"nonce": "a1b2c3d4e5f6...",
"message": "Sign in to 2Settle\n\nAddress: 0xabc...\nNonce: a1b2c3d4e5f6...\nIssued At: 2026-07-10T09:00:00.000Z",
"expiresInSec": 300
}
}
Notes:
- Sign the entire
messagestring exactly as returned — the server re-derives the same message shape when checking the signature, so altering whitespace or formatting client-side will fail verification. - The nonce expires after 5 minutes if not used.