/
v3.0.11Get access

loginClientWithMetamask

This command initiates a wallet-based authentication flow leveraging MetaMask. Instead of traditional credentials (such as username and password), the client proves identity by signing a server-provided message with their private key. The system then verifies the signature against the public wallet address to confirm ownership.

Request parameters:

Name
DescriptionTypeValuesDefault
uri
The URI of the login endpointstring--
email
User email addressstring--
domain
The domain of the applicationstring--
region
Region or locale of the userstring--
version
Authentication versionstring--
currency
Preferred currency of the userstring--
username
Username for loginstring--
password
Password for loginstring--
chainId
Blockchain chain IDnumber--
issuedAt
Timestamp when the signature was issuedstring--
signature
MetaMask-generated signature for authenticationstring--
publicAddress
User's public wallet addressstring--

Call example:

loginClientWithMetamask({
  uri: 'https://www.vbetftn.com',
  domain: 'www.vbetftn.com',
  version: '1',
  chainId: 1,
  issuedAt: '2026-02-24T15:04:49.515Z',
  signature: '0x22fa33bb9dda8177311bcf778c637708b2650b93cf690814bb4cdd7498d3dda06a47ec9b56cee6018fde2fcfcd1f3f775093391b4af0f4b638fc350dfbec33b81c',
  publicAddress: '0xb7e34f8236DE929052f4C735280bF8eE7cbAA410'
})

Response examples:

{
  UserId: 190591310,
  UserName: '#190591310',
  Balance: 0,
  Unplayed: 0,
  Bonus: 0,
  SportBonus: 0,
  CasinoBonus: 0,
  CasinoBonusWin: 0,
  Frozen: 0,
  CasinoFrozen: 0,
  BonusWin: 0,
  IsUsingLoyaltyProgram: true,
  LoyaltyPoint: 0,
  LoyaltyEarnedPoints: 0,
  LoyaltyExchangedPoints: 0,
  LoyaltyLastEarnedPoints: 0,
  LoyaltyPointUsagePeriod: 0,
  LoyaltyMaxExchangePoints: 0,
  LoyaltyMinExchangePoints: 0,
  BonusMoney: 0,
  Token: '37ABB76CE85220837DE141BBF2BCA1E7',
  Currency: 'FTN',
  Currencies: 'TUS',
  CurrencyName: 'FTN',
  Email: '[email protected]',
  Region: '  ',
  IsVerified: false,
  IsTaxApplicable: false,
  ActiveStep: 1,
  ActiveStepState: 4,
  IsSubscribedToNewsletter: false,
  HasFreeBets: false,
  LoyaltyLevelId: 3270,
  LoyaltyLevelOrder: 1,
  LoyaltyLevelName: '1',
  IsSuperBetAvailable: true,
  CounterOfferMinAmount: 18.39,
  SportsbookProfileId: 38,
  IsGDPRPassed: false,
  IsCashOutAvailable: true,
  IsResident: false,
  IsAgent: false,
  LastLoginDate: 1759694491,
  RegistrationDate: '2024-12-05',
  IsSubscribeToEmail: true,
  IsSubscribeToSMS: true,
  IsSubscribeToBonus: true,
  IsSubscribeToInternalMessage: true,
  IsSubscribeToPushNotification: true,
  IsSubscribeToPhoneCall: true,
  IsSubscribeToDirectMail: true,
  IsSubscribeToCasinoEmail: true,
  IsSubscribeToCasinoNewsletter: true,
  IsSubscribeToCasinoSMS: true,
  IsSubscribeToCasinoBonus: true,
  IsSubscribeToCasinoInternalMessage: true,
  IsSubscribeToCasinoPushNotification: true,
  IsSubscribeToCasinoPhoneCall: true,
  IsBonusAllowed: true,
  UnreadCount: 0,
  PartnerId: 18749451,
  Status: 1,
  TermsAndConditionsVersion: '1',
  TermsAndConditionsAcceptanceDate: '2024-12-05',
  IsTwoFactorAuthenticationEnabled: true,
  AuthenticationStatus: 0,
  IsNewClient: false,
  Language: 'en',
  ExternalId: '0xb7e34f8236DE929052f4C735280bF8eE7cbAA410',
  IsEmailVerified: false,
  IsPhoneVerified: false,
  IsMobilePhoneVerified: false,
  DocRegionId: 0,
  DepositCount: 0,
  ChildId: 243963454,
  NeedsSubscribtionsUpdate: false
}

Response parameters:

NameDescriptionTypeValues
UserId
Unique internal identifier of the user.number-
UserName
System-generated username.string-
ExternalId
Blockchain wallet address used for MetaMask authentication.string-
Token
Authentication token used for authorized API requests.string-
IsTwoFactorAuthenticationEnabled
Indicates if 2FA is enabled.booleantrue / false
AuthenticationStatus
Current authentication state (e.g., pending, verified).number-
IsVerified
Indicates whether the account is identity verified.booleantrue / false
IsEmailVerified
Email verification status.booleantrue / false
IsPhoneVerified
Phone verification status.booleantrue / false
IsMobilePhoneVerified
Mobile phone verification statusbooleantrue / false
IsGDPRPassed
Indicates if GDPR consent is completed.booleantrue / false
Balance
Main account balance.number-
Unplayed
Amount requiring wagering before withdrawal.number-
Bonus
Active bonus balance.number-
BonusMoney
Bonus money available.number-
BonusWin
Winnings generated from bonuses.number-
SportBonus
Sportsbook bonus balance.number-
CasinoBonus
Casino bonus balance.number-
CasinoBonusWin
Casino bonus winnings.number-
Currency
Primary account currency codestring-
Currencies
Available currency codesstring-
CurrencyName
Display currency namestring-
Frozen
Frozen sportsbook balancenumber-
CasinoFrozen
Frozen casino balancenumber-
CounterOfferMinAmount
Minimum counter-offer amountnumber-
DepositCount
Total successful depositsnumber-
IsUsingLoyaltyProgram
Loyalty program participation flagbooleantrue / false
LoyaltyPoint
Current loyalty points balancenumber-
LoyaltyEarnedPoints
Total earned loyalty pointsnumber-
LoyaltyExchangedPoints
Total exchanged loyalty pointsnumber-
LoyaltyLastEarnedPoints
Last earned loyalty pointsnumber-
LoyaltyPointUsagePeriod
Loyalty usage period limitnumber-
LoyaltyMaxExchangePoints
Maximum exchangeable loyalty pointsnumber-
LoyaltyMinExchangePoints
Minimum exchangeable loyalty pointsnumber-
LoyaltyLevelId
Loyalty level identifiernumber-
LoyaltyLevelOrder
Loyalty level ranking ordernumber-
LoyaltyLevelName
Loyalty level display namestring-
sSubscribedToNewsletter
Subscribed to main newsletterbooleantrue / false
IsSubscribeToEmail
Email subscription statusbooleantrue / false
IsSubscribeToSMS
SMS subscription statusbooleantrue / false
IsSubscribeToBonus
Bonus offer subscriptionbooleantrue / false
IsSubscribeToInternalMessage
Internal message subscriptionbooleantrue / false
IsSubscribeToPushNotification
Push notification subscriptionbooleantrue / false
IsSubscribeToPhoneCall
Phone call subscriptionbooleantrue / false
IsSubscribeToDirectMail
Direct mail subscriptionbooleantrue / false
IsSubscribeToCasinoEmail
Casino email subscriptionbooleantrue / false
IsSubscribeToCasinoNewsletter
Casino newsletter subscriptionbooleantrue / false
IsSubscribeToCasinoSMS
Casino SMS subscriptionbooleantrue / false
IsSubscribeToCasinoBonus
Casino bonus subscriptionbooleantrue / false
IsSubscribeToCasinoInternalMessage
Casino internal message subscriptionbooleantrue / false
IsSubscribeToCasinoPushNotification
Casino push notification subscriptionbooleantrue / false
IsSubscribeToCasinoPhoneCall
Casino phone call subscriptionbooleantrue / false
NeedsSubscribtionsUpdate
Subscription update required flagbooleantrue / false
HasFreeBets
Indicates free bets availabilitybooleantrue / false
IsSuperBetAvailable
Super bet feature availabilitybooleantrue / false
IsCashOutAvailable
Cash-out feature availabilitybooleantrue / false
IsBonusAllowed
Bonus eligibility flagbooleantrue / false
IsAgent
Agent account indicatorbooleantrue / false
SportsbookProfileId
Sportsbook profile identifiernumber-
LastLoginDate
Last login Unix timestampnumber-
RegistrationDate
Account registration datestring-
ActiveStep
Current onboarding stepnumber-
ActiveStepState
Onboarding step state codenumber-
UnreadCount
Unread messages countnumber-
Email
Registered email addressstring-
Region
User region codestring-
IsTaxApplicable
Tax rules applicable flagbooleantrue / false
IsResident
Residency confirmation flagbooleantrue / false
TermsAndConditionsVersion
Accepted terms versionstring-
TermsAndConditionsAcceptanceDate
Terms acceptance datestring-
DocRegionId
Document region identifiernumber-
PartnerId
Affiliate partner identifiernumber-
ChildId
Linked child account identifiernumber-
Status
Account status codenumber-
Language
User preferred language codestring-