API authentication

Endpoints for API authentication (optional)

Generate Login Message

get

Generate a login message for a specific wallet address and chain.

• wallet_address: The wallet address of the user

• selected_chain: The chain of the user

Query parameters

wallet_addressstringRequired

selected_chainstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/api/generate-login-message

HTTPcURLJavaScriptPython

GET /api/generate-login-message?wallet_address=text&selected_chain=text HTTP/1.1
Host: 
Accept: */*

{
  "message": "text",
  "nonce": "text",
  "expiration": 1
}

Login

post

Login with a specific wallet address and chain.

• wallet_address: The wallet address of the user

• selected_chain: The chain of the user

• nonce: The nonce of the message

• message: The message to sign

• signature: The signature of the message

Body

application/json

wallet_addressstringRequired

selected_chainstringRequired

noncestringRequired

messagestringRequired

signatureany ofRequired

integer[]Optional

or

stringOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/api/login

HTTPcURLJavaScriptPython

POST /api/login HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "wallet_address": "text",
  "selected_chain": "text",
  "nonce": "text",
  "message": "text",
  "signature": [
    1
  ]
}

{
  "success": true,
  "message": "text",
  "session_id": "text",
  "expires_at": "2026-01-20T03:26:07.688Z"
}

Logout

post

Logout from the API.

• session_id: The session ID of the user

Body

application/json

session_idstringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/api/logout

HTTPcURLJavaScriptPython

POST /api/logout HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "session_id": "text"
}

{
  "success": true,
  "message": "text"
}