Airdrop & Sybil Screener Guide TokenAddy
Screening a wallet list for an airdrop, marketplace vetting, or sybil detection? Everything below is plain HTTP + JSON — no SDK, no API key signup, and no blockchain node required.
Step 1 — Free triage (no payment)
Start with the free endpoints. Every one accepts a raw 0x… address or an ENS name, and returns deterministic, on-chain-derived data you can cite per wallet.
# Deterministic 0-100 trust score (direct-risk: 0 = safest)
curl https://tokenaddy.com/trust/0xADDR1
# 0-100 activity score from public chain data
curl https://tokenaddy.com/score/0xADDR1
# ETH balance, top tokens, recent txs, NFTs held
curl https://tokenaddy.com/holdings/0xADDR1
# Contracts this wallet created on Base — serial token deployers (rug clusters) are flagged
curl https://tokenaddy.com/deployed/0xADDR1
# Likely human vs agent (heuristic)
curl https://tokenaddy.com/kind/0xADDR1Triage tips: a fresh wallet with a high token count and near-zero history is a classic airdrop-farmer shape. /deployed flagging many same-day token deploys is a rug-cluster signal. Cross-check anything suspicious with the paid deep report below.
Step 2 — Deep reports, batched $0.05 / 10 wallets
When free signals warrant a closer look, the paid endpoints bundle everything into one report per wallet. Payment uses the x402 protocol: the first request returns 402 with a payment manifest — send the quoted USDC-on-Base amount to the payTo address, then retry with ?x402Tx=0xYOUR_TX_HASH. Payment hashes are single-use.
# One deep report ($0.01): score + trust + holdings in one payload
curl https://tokenaddy.com/report/0xADDR1
# Ten deep reports in one call ($0.05) — raw addresses AND .eth names mix freely
curl "https://tokenaddy.com/batch-report?names=0xADDR1,0xADDR2,0xADDR3,alice.eth,vitalik.eth"Step 3 — Batch name availability $0.005 / up to 50 names
Checking whether a list of bare names is free (for branding, impersonation watch, or squat checks) across ENS and DNS namespaces:
curl "https://tokenaddy.com/bulk-tlds?names=alice,bob,carol"Pricing at a glance
| Endpoint | What you get | Price |
|---|---|---|
/trust, /score, /holdings, /deployed, /kind | per-wallet triage signals | free |
GET /report/<addr> | deep wallet report (score + trust + holdings) | $0.01 |
GET /batch-report?names=… | up to 10 deep reports, one call | $0.05 |
GET /bulk-tlds?names=… | availability for up to 50 bare names | $0.005 |
All scores are deterministic server-side calculations from public chain data — the same wallet always yields the same numbers, so your audit trail is reproducible. TokenAddy never requests keys, signatures, or approvals; lookups are read-only.
Machine-readable contract
Agents and frameworks can fetch GET /openapi.json for the full endpoint schema, or GET /llms.txt for a plain-text summary. Full agent docs: /agents.