Skip to main content

Authentication

Email OTP → JWT

Request a code:
curl -X POST http://localhost:3004/auth/request-code \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'
Verify a code:
curl -X POST http://localhost:3004/auth/verify-code \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","code":"123456"}'
Response:
{ "access_token": "..." }

Hybrid auth

Some routes accept either:
  • Authorization: Bearer <JWT>
  • x-api-key: <API_KEY>
JWT-only routes:
  • POST /wallets/link/init
  • POST /wallets/link/verify
  • GET /wallets/link
  • GET /balances
  • POST /transfers