POST
/
auth
/
web3
/
verify-login
curl --request POST \
  --url https://api.copin.io/auth/web3/verify-login \
  --header 'Content-Type: application/json' \
  --data '{
  "address": "<string>",
  "sign": "<string>",
  "time": "<string>",
  "referralCode": "<string>"
}'
{
  "id": "<string>",
  "username": "<string>",
  "role": "<string>",
  "isBlocked": true,
  "isActivated": true,
  "blockNote": "<string>",
  "referralCode": "<string>",
  "isSkippedReferral": true,
  "copyTradeQuota": 123,
  "plan": 123,
  "createdAt": "<string>",
  "access_token": "<string>",
  "isAddedReferral": true
}

​
Request Body

​
address
string
required

The Ethereum wallet address of the user attempting to login

​
sign
string
required

The signature created by signing the verification code with the user’s private key. Message: I want to login on Copin.io at ${time}. Login code: ${verifyCode}

​
time
string
required

Date-time of the verification request

​
referralCode
string

Optional referral code to apply to the user’s account

​
Request Example

curl --request POST \
--url "https://api.copin.io/auth/web3/verify-login" \
--header 'Content-Type: application/json' \
--data '{
 "address": "0x1535484c1eec1d203fe1a53ea11a621a884ae067",
 "sign": "0x5d99b6f7f6d1f73d1a26497f2b1c89b24c1adf257d861450123ae210f604e62c0fffffff886efdb0253cd39f9ecb4c49c9f5a4b95903cf564db34c79363e11ccf1b",
 "time": "2025-04-14T09:55:27.767Z"
}'

​
Response

​
id
string

Unique identifier for the user

​
username
string

User’s wallet address used as username

​
role
string

User’s role in the system (e.g., “guest”, “user”, “admin”)

​
isBlocked
boolean

Indicates if the user account is blocked

​
isActivated
boolean

Indicates if the user account is activated

​
blockNote
string

Note about block reason if the account is blocked

​
referralCode
string

User’s referral code that can be shared with others

​
isSkippedReferral
boolean

Indicates if the user skipped entering a referral code

​
copyTradeQuota
number

Number of copy trades the user can create

​
plan
number

User’s subscription plan level

​
createdAt
string

Timestamp when the user account was created

​
access_token
string

JWT token to be used for authenticated API calls

​
isAddedReferral
boolean

Indicates if the user has added a referral code

{
    "id": "654849d04857e1f744646cdd",
    "username": "0x1535484c1eec1d203fe1a53ea11a621a884ae067",
    "role": "guest",
    "isBlocked": false,
    "isActivated": true,
    "blockNote": "",
    "referralCode": "IEZ8LC",
    "isSkippedReferral": true,
    "copyTradeQuota": 3,
    "plan": 0,
    "createdAt": "2023-11-06T02:05:04.079Z",
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IjB4MTk2YWUxNkE5Mzg3YTNEYzVEZTgxMTQ2N0EyRTM3RDdGZUJlRDMwNCIsInRpbWUiOjE3NDQ2MjQwNjQyMTgsImFjY2VzcyI6IllrN1NjY0FrQ0MxNzQ0NjI0MDY0MjE4IiwiaWF0IjoxNzQ0NjI0MDY0LCJleHAiOjE3NDUyMjg4NjR9.09g22yhvApz64IPw3mGY0qsLLZqzeGUrKhcC27saLtr",
    "isAddedReferral": false
}