Agent Number

POST /auth/nonce

Issue a single-use nonce for wallet-signature recovery

Description

Step 1 of the recovery flow. Returns a fresh, single-use nonce with a 5-minute TTL. Sign `Sign in to really.com SMS\nNonce: <nonce>` with the wallet that owns the subscription, then POST the signature to `/auth`. Public — no bearer required.

Authentication

None. Public endpoint, no auth required.

Code samples

Pick your runtime. Every sample is in the page source — switching tabs is for your eyes.

curl https://agentnumber.really.com/auth/nonce \
  --request POST \
  --header 'content-type: application/json' \
  --data '{
  "address": "0x0000000000000000000000000000000000000000"
}'

Request body

FieldTypeDescription
address string Optional. The wallet you intend to authenticate as. Server may use it to scope rate limits but does not require it.
Example: 0x0000000000000000000000000000000000000000

Example body

{
  "address": "0x0000000000000000000000000000000000000000"
}

Responses

200 Nonce issued.

{
  "nonce": "n_abcdef0123456789abcdef0123456789",
  "expires_in": 300
}