ethos_score
Credibility score for a userkey
Is this wallet, X account or person trustworthy? Ethos credibility score (0 to 2800) and level, from untrusted to renowned, built from peer reviews, ETH-backed vouches, slashes and linked on-chain and social history. Use it before trading with, following, quoting or paying an unknown counterparty, to rank accounts by reputation, or to flag likely scams and bots. Takes an EVM address, X handle or account id, Discord or Telegram id, or Ethos profile id. Free, no payment or key; the same answer as the free Ethos API. Example input: {"userkey":"service:x.com:username:ethos_network"}. Example output: {"score":2441,"level":"revered"}
Parametersuserkeyrequired
ethos_user_by_x
Ethos user by X (Twitter) handle or account id
Who is behind an X (Twitter) handle, and can they be trusted? The Ethos profile for a handle or numeric account id: display name, credibility score and status, every wallet address and social account linked to the same person, XP, influence factor, and how many positive, neutral and negative reviews and vouches they have received. Use it to vet an account before engaging, resolve a handle to its wallets, or enrich a mention with reputation. Free, no payment or key; the same answer as the free Ethos API. Example input: {"handle":"ethos_network"}. Example output: {"id":32936,"profileId":1,"displayName":"Ethos","username":"ethos_network","avatarUrl":"https://pbs.twimg.com/profile_images/2074951227599646720/85k3GJ-s.jpg","score":2441,"status":"ACTIVE","userkeys":["profileId:1","service:x.com:1234567890","address:0x1234…"],"xpTotal":4076702,"influenceFactor":276,"stats":{"review":{"received":{"positive":120,"neutral":3,"negative":2}},"vouch":{"received":{"count":40}}}}
Parametershandlerequired
ethos_user_by_address
Ethos user by EVM address
Who owns this wallet, and what is their reputation? The Ethos profile holding an EVM address: display name, X handle and other linked accounts, credibility score and status, XP, influence factor, and review and vouch counts. Use it to attach a name and trust level to a counterparty address before a trade, transfer, airdrop or allowlist decision, or to screen addresses in a transaction for known bad actors. Free, no payment or key; the same answer as the free Ethos API. Example input: {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}. Example output: {"id":32936,"profileId":1,"displayName":"vitalik.eth","username":null,"avatarUrl":"https://pbs.twimg.com/profile_images/2074951227599646720/85k3GJ-s.jpg","score":1311,"status":"INACTIVE","userkeys":["profileId:1","service:x.com:1234567890","address:0x1234…"],"xpTotal":4076702,"influenceFactor":276,"stats":{"review":{"received":{"positive":120,"neutral":3,"negative":2}},"vouch":{"received":{"count":40}}}}
Parametersaddressrequired
ethos_search_users
Search Ethos users
Find a person or project on Ethos when you only have a name, a partial handle or part of an address. Returns matching profiles with credibility score, status, linked wallets and social accounts, paginated. The starting point when a user asks about someone by name: search, pick the match, then score or profile it by userkey. Also useful for disambiguating impersonators from the real account. Free, no payment or key; the same answer as the free Ethos API. Example input: {"query":"vitalik","limit":"5"}. Example output: {"values":[{"id":32936,"profileId":1,"displayName":"Ethos","username":"ethos_network","avatarUrl":"https://pbs.twimg.com/profile_images/2074951227599646720/85k3GJ-s.jpg","score":2441,"status":"ACTIVE","userkeys":["profileId:1","service:x.com:1234567890","address:0x1234…"],"xpTotal":4076702,"influenceFactor":276,"stats":{"review":{"received":{"positive":120,"neutral":3,"negative":2}},"vouch":{"received":{"count":40}}}}],"total":1,"limit":5,"offset":0}
Parameterslimitqueryrequiredoffset
ethos_xp
Total XP for a userkey
How active and invested is this person in the Ethos reputation network? Total XP earned across all seasons for a userkey (address, X handle or id, Discord or Telegram id, or profile id). XP accrues from reviews, vouches, invitations and other contributions, so it separates long-standing, engaged members from fresh or dormant accounts. Use it alongside the credibility score to weigh how much history stands behind a reputation. Free, no payment or key; the same answer as the free Ethos API. Example input: {"userkey":"profileId:1"}. Example output: 4076702
Parametersuserkeyrequired
