Skip to main content

Request Wallet Nonce

POST /v1/users/auth/wallet/nonce

Auth: None

FieldTypeRequiredDescription
addressstringYesEVM 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 message string 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.