Sign in

v1

latestOpenAPI 3.0.32026-08-041747125.8 KB
Auth

Verify wallet challenge

Verifies the signed challenge and issues a JWT for authenticated requests.

Rate limiting: 1 request per 12 seconds per client IP. Excess requests receive HTTP 429 with Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers (see RateLimitExceeded response).

post/v1/auth/verify

Request body

walletAddressstring required

User's Ethereum wallet address (must be checksummed per EIP-55)

signaturestring required

Signed challenge message using personal_sign method

chain'ETHEREUM' | 'BASE' | 'POLYGON' | 'ARBITRUM' | 'OPTIMISM' | 'AVALANCHE' | 'LINEA' nullable

The blockchain network for signature verification. Defaults to "ETHEREUM" if omitted. Required for Smart Contract Wallets to specify the chain on which verification is performed.

Example request

{
  "walletAddress": "0x14848abF0125De79e0A5F3caA7F4EA9664a988e8",
  "signature": "0x9c1efc293e476948580195863a66203816a3d437a04a92df95c1be979010031c35dbd856110eb161aa59f72cbfe49ff3a64fda3bdb094c2c321edfb13c8215161b",
  "chain": "ETHEREUM"
}

Response

Challenge verified successfully

jwtstring required

Issued JWT for authenticated requests