POST /auth/login

Sign in with EVM wallet

Sign in with EVM wallet.

operationId: login

Not reachable through CCXT. Session/credential lifecycle. CCXT takes credentials as constructor config; it never mints them.

Authentication: none declared, and the contract declares no document-level default — this operation carries its own signature in the request body. See the description above.

Submit an EIP-191 personal_sign signature to receive a session token. The session token is used to create and manage API keys via /keys endpoints. For trading, use HMAC API keys instead. Session tokens expire after 24 hours.

Request body

Required. LoginRequest — application/json.

{
  "message": "Sign in to Nexus Exchange",
  "signature": "0x1234...abcd"
}

Responses

Status	Body	Meaning
200	LoginResponse	Session created
401	— (no schema declared)	Signature verification failed
500	— (no schema declared)	code=INTERNAL_ERROR — the session store write failed (M3.15, ENG-10681: the Postgres-backed session store has no in-memory fallback, so a write failure surfaces here instead of degrading silently)

Example

cURL

curl -X POST 'https://exchange.nexus.xyz/api/exchange/auth/login' \
  -H 'Content-Type: application/json' \
  -d '{
  "message": "Sign in to Nexus Exchange",
  "signature": "0x1234...abcd"
}'

Python

import requests

headers = {
    "Content-Type": "application/json"
}
payload = {
    "message": "Sign in to Nexus Exchange",
    "signature": "0x1234...abcd"
}

response = requests.post("https://exchange.nexus.xyz/api/exchange/auth/login", headers=headers, json=payload)
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://exchange.nexus.xyz/api/exchange/auth/login", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "message": "Sign in to Nexus Exchange",
    "signature": "0x1234...abcd"
  }),
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
console.log(await response.json());

---

_{Generated from eng/apps/exchange/api/openapi.json (spec 0.9.36). Do not edit by hand — regenerate with python3 product/docs/tools/api-reference/generate.py. Hand-authored context lives in the Guides pages.}