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
get
/api/generate-login-message
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
wallet_addressstringRequired
selected_chainstringRequired
noncestringRequired
messagestringRequired
signatureany ofRequired
integer[]Optional
or
stringOptional
Responses
200

Successful Response

application/json
post
/api/login
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": "2025-12-04T20:56:28.620Z"
}

Logout

post

Logout from the API.

  • session_id: The session ID of the user

Body
session_idstringRequired
Responses
200

Successful Response

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

{
  "session_id": "text"
}
{
  "success": true,
  "message": "text"
}
PreviousGetting startedNextVerification

Last updated