Skip to main content
POST
/
auth
/
login
User login
curl --request POST \
  --url https://api.limitless.exchange/auth/login \
  --header 'Content-Type: application/json' \
  --header 'x-account: <x-account>' \
  --header 'x-signature: <x-signature>' \
  --header 'x-signing-message: <x-signing-message>' \
  --data '
{
  "client": "eoa",
  "smartWallet": "0x1234567890123456789012345678901234567890",
  "r": "<string>"
}
'
{
  "account": "0x1234567890123456789012345678901234567890",
  "displayName": "0x1234...7890",
  "smartWallet": "0x0987654321098765432109876543210987654321",
  "client": "eoa"
}
Cookie-based session auth is deprecated. For programmatic access, use an API key (X-API-Key header) instead.

Headers

​
x-account
string
required

The Ethereum address of the user

​
x-signing-message
string
required

The signing message generated by the server

​
x-signature
string
required

The signature generated by signing the message with the user's wallet

Body

application/json
​
client
enum<string>
required

Client type for authentication

Available options:
eoa,
etherspot,
base
Example:

"eoa"

​
smartWallet
string

Smart wallet address (required for Smart Wallet client)

Example:

"0x1234567890123456789012345678901234567890"

​
r
string

Referral code associated with the user who referred (invited) this user

Response

User has been successfully logged in and a session cookie has been set

​
account
string
Example:

"0x1234567890123456789012345678901234567890"

​
displayName
string
Example:

"0x1234...7890"

​
smartWallet
string | null
Example:

"0x0987654321098765432109876543210987654321"

​
client
string
Example:

"eoa"