logo
API

WalletTag Wallet Scoring API

Create a free WalletTag account to access our wallet scoring API. Get real-time trust scores, risk buckets and activity signals for any EVM wallet via simple REST and GraphQL endpoints.

View Documentation Test the API

Live API Demo

Test our wallet scoring endpoint from the browser using a real wallet address.

GEThttps://score-api.wallet-tag.com/score

Sign up to get your API key and start integrating

elipsePlatforms

Example Use Cases

Where WalletTag fits into real-world Web3 workflows.

Onboarding & Access Control

  • • Login, Sign-Up & Access
  • • Whitelisting & Memberships
  • • Launchpads & Presale Systems

Transactions & Claims Protection

  • • Airdrop & Reward Distribution
  • • Token Claim Systems & Staking
  • • Payment Gateways & Marketplaces

Trust Scoring & Monitoring

  • • Real-Time Wallet Trust Scores
  • • API Usage & Risk Insights
  • • Behavioral Flagging & Alerts

Wallet Score API

Get wallet trust scores and transaction history across multiple programming languages. From JavaScript with fetch, to Python with requests, and Ruby with HTTParty. Each example shows how to query wallet scores with proper authentication headers.

View Documentation
wallet-score.js
// Wallet Score API Clientconst API_BASE = 'https://score-api.wallet-tag.com';const API_KEY = 'your-api-key';/** * Fetches wallet score and analysis * @param {string} address - Ethereum wallet address * @returns {Promise<Object>} Wallet score data */async function getWalletScore(address) {  const response = await fetch(`${API_BASE}/score?address=${address}`, {    headers: {      'X-API-KEY': API_KEY,      'Accept': '*/*'    }  });  if (!response.ok) {    throw new Error(`HTTP error! status: ${response.status}`);  }  return response.json();}// Usage Exampleconst walletAddress = '0x10E0271ec47d55511a047516f2a7301801d55eaB';const scoreData = await getWalletScore(walletAddress);console.log(`Wallet Score: ${scoreData.score}`);console.log(`Bucket: ${scoreData.bucket}`);console.log(`Age: ${scoreData.derived_features.age_days} days`);console.log(`Transactions: ${scoreData.derived_features.tx_any_total}`);console.log(`Net Worth: $${scoreData.derived_features.total_networth_usd}`);// Response Example:// {//   "score": 69,//   "bucket": "High",//   "score_breakdown": {//     "base_score": 60,//     "age_delta": 4,//     "transaction_delta": 1,//     "net_worth_delta": 1,//     "recency_delta": 1,//     "multi_chain_delta": 2,//     "gas_dust_penalty": 0,//     "single_touch_penalty": 0,//     "malicious_penalty": 0,//     "fairness_floor_applied": false//   },//   "flags": {//     "virtually_no_activity": false,//     "malicious_flag": false//   },//   "malicious": {//     "cybercrime": false,//     "money_laundering": false,//     "sanctioned": false//   },//   "derived_features": {//     "tx_any_total": 331,//     "total_networth_usd": 2850.47,//     "first_tx": "2018-07-08T12:29:40Z",//     "last_tx": "2025-11-05T13:11:58Z",//     "age_days": 2687,//     "days_since_last": 10,//     "active_chain_count": 8//   },//   "transaction_summary": {//     "first_transaction": { ... },//     "last_transaction": { ... },//     "transaction_list": [ ... ]//   }// }