⚙️EtherScore API

How to use EtherScore API to integrate onchain reputations

Partners can integrate EtherScore's reputations via the EtherScore API.

See live integrations on Etherscan and Blockscout explorers here:

🤝Integrations examples

To get a free API key, please reach us at [email protected] , or in our Discord server.

---

The EtherScore API provides comprehensive onchain reputation data for integration with Dapps or communities. The data includes various user metrics, such as:

• User Profile:

  • Verification status with a verified badge icon

  • User tier and rank, with associated images

  • Badge statistics, including maximum and user-minted badge counts

• Latest User Attestation:

  • Recently attested badge count and tier

• Additional Information:

  • Profile URL linked to the user's wallet address

  • Tooltips providing guidance on badges and tiers

{
	success: true,
	data: {
			user_metrics: {
				user_profile: {
					verified: "Verified",
					verified_image: "<server>/images/icons/Avatar_Check_Verified_Icon.svg",
					tier_image: "<server>/images/reputationTiers/<user_tier>.png",
					max_badge_count: <current max count of badges>,
					user_badge_count: <current user-minted count of badges>,
					user_rank: <current user rank>,
					user_tier: <current user tier>,
					user_badge_percentage: <user_badge_count / max_badge_count>,
				},
				latest_user_attestation: {
					tier_image: "<server>/images/reputationTiers/<user_tier>.png",
					max_badge_count: <lastly attested max count of badges>,
					user_badge_count: <lastly attested user-minted count of badges>,
					user_rank: <lastly attested user rank>,
					user_tier: <lastly attested user tier>
				},
				profile_url: <server>/<wallet address>,
				tooltip_badges: “tooltip text for badges”,
				tooltip_tiers: “tooltip text for tiers”,
			}
		}
}