Skip to content
onelayer.
All tools

Tool detail

human

Returns a 0-255 humanity/sybil-resistance score and optional per-method verification flags for an EVM wallet address.

Categories: Compliance screening, Agent trust safety

Use when

  • check whether a wallet address belongs to a verified human
  • get a pass/fail verdict against a minimum humanity score threshold
  • check specific verification methods (e.g. Telegram, Apple ID, 2FA) for a wallet

Not for

  • not identity/KYC data — returns verdicts and scores only, never raw personal data
  • not for non-EVM wallets — requires a 0x-prefixed EVM address

Inputs

GET query params: wallet (0x EVM address, required); optional check (CSV of methods), include (CSV), match (CSV key:value), min_score (0-255)

Admitted input schema

{
  "type": "object",
  "properties": {
    "check": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional CSV of specific verification methods to check (minimal-disclosure: buyer must name them; we don't enumerate). Returns `verifications: {method: bool}` for ONLY the methods asked. Valid methods: recaptcha, google, discord, line, telegram, apple, g2fa, onchain, worldid."
    },
    "include": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional CSV of richer fields: `verified_at` (SBT mint timestamp, useful for sybil-pattern detection), `dimensions_filled` (count of non-zero matrix bytes, profile completeness signal)."
    },
    "match": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional CSV of attribute match conditions `key:value` (AND-ed). Returns pass/fail per condition + overall `matched` — NEVER the raw values (minimal disclosure). Keys: age, gender, occupation, income, social, web3, ai, risk, interest. A `+` suffix on ordered keys (age/income/web3/ai/risk) means '≥ this level'. Examples: `age:25-34`, `income:200-500+`, `social:instagram`, `interest:travel`."
    },
    "min_score": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$",
      "description": "Optional integer 0-255. When set, response adds `passes: bool` indicating whether the wallet's humanity score meets the threshold. Reference levels: 15 = baseline (reCAPTCHA + sybil filter), 45 = + Google OAuth, 70 = + Apple ID, 105 = + 2FA, 255 = full verification stack."
    },
    "wallet": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "EVM address (0x-prefixed, 40 hex chars). The wallet to verify."
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://human.twin3.ai/v1/human

Payment

Protocol
x402
Listed price
0.001 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://human.twin3.ai/v1/human
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z