Authentication

User authentication and management

Get user by ID

get

Query parameters

userIdstringRequired

Responses

200

User found

application/json

400

Bad request

application/json

404

Resource not found

application/json

500

Internal server error

application/json

get

/auth/user

HTTPcURLJavaScriptPython

GET /api/auth/user?userId=text HTTP/1.1
Host: 
Accept: */*

{
  "id": "text",
  "walletAddress": "text",
  "createdAt": "2026-01-17T06:06:18.504Z",
  "updatedAt": "2026-01-17T06:06:18.504Z"
}

Create or retrieve a user

post

Body

application/json

dynamicUserIdstringRequired

walletAddressstring | nullableOptional

Responses

200

Existing user returned

application/json

201

New user created

application/json

400

Bad request

application/json

500

Internal server error

application/json

post

/auth/user

HTTPcURLJavaScriptPython

POST /api/auth/user HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "dynamicUserId": "text",
  "walletAddress": "text"
}

{
  "id": "text",
  "walletAddress": "text",
  "createdAt": "2026-01-17T06:06:18.504Z",
  "updatedAt": "2026-01-17T06:06:18.504Z",
  "isNewUser": true
}