🔐
Walver.io Docs
  • Walver.io Documentation
  • Introduction to Walver.io
  • Getting Started with Walver.io
  • Token Gating
  • Webhook Integration
  • The Verification Process
  • Creator Dashboard
  • Best Practices
  • Security Features
  • Walver Python SDK Documentation
  • Walver JavaScript SDK Documentation
  • Signature Verification Python package
  • JavaScript Widget Documentation
  • Frequently Asked Questions (FAQ)
  • Api reference
    • Getting started
    • API authentication
    • Verification
    • Folders
    • API Keys
    • Models
Powered by GitBook
On this page
  1. Api reference

API authentication

PreviousGetting startedNextVerification

Endpoints for API authentication (optional)

  • GETGenerate Login Message
  • POSTLogin
  • POSTLogout

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
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
422
Validation Error
application/json
post
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-06-21T03:33:39.037Z"
}

Logout

post

Logout from the API.

  • session_id: The session ID of the user

Body
session_idstringRequired
Responses
200
Successful Response
application/json
422
Validation Error
application/json
post
POST /api/logout HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 21

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