oyi77 Overview
gate-info-tokenonchain runs a token on-chain investigation playbook using block explorer APIs (Etherscan for EVM; equivalent explorers for BSC/Solana/Polygon). It pulls supply, holder concentration, recent transfer activity, and contract source-verification status. Standalone, tool-agnostic rewrite of the upstream gate-info-tokenonchain skill. For risk scoring (honeypot/tax), route to gate-info-riskcheck.
When to Use
- "Check the on-chain activity for [token]"
- "How concentrated are [token] holders"
- "Is [token] contract verified / active transfers"
- "On-chain footprint for [contract address]"
When NOT to Use
- Risk scoring (honeypot, buy/sell tax) — use
gate-info-riskcheck. - Single-coin market fundamentals — use
gate-info-coinanalysis. - DeFi protocol TVL — use
gate-info-defianalysis.
Workflow
Step 1 — Supply + verification
# Free Etherscan key (ETHERSCAN_KEY) for EVM tokens
curl -s "https://api.etherscan.io/api?module=stats&action=tokenSupply&contractaddress=0xdac17f958d2ee523a2206206994597c13d831ec7&apikey=$ETHERSCAN_KEY" | jq '.result'
# Contract source verification status
curl -s "https://api.etherscan.io/api?module=contract&action=getsourcecode&address=0xdac17f958d2ee523a2206206994597c13d831ec7&apikey=$ETHERSCAN_KEY" | jq '.result[0].CompilerVersion, .result[0].SourceCode | length'
Step 2 — Recent transfers (activity proxy)
curl -s "https://api.etherscan.io/api?module=account&action=tokentx&contractaddress=0xdac17f958d2ee523a2206206994597c13d831ec7&page=1&offset=100&sort=desc&apikey=$ETHERSCAN_KEY" \
| jq '[.result[] | {from: .from, to: .to, value: .value, ts: .timeStamp}] | length' # count recent transfers
Step 3 — Holder concentration
Use the explorer UI "Holders" tab or the tokenholderlist (Pro) endpoint; if unavailable, sample top transfer counterparties from Step 2 to estimate concentration qualitatively.
Step 4 — Synthesize
## Token On-Chain: [contract] (playbook: token_onchain)
### Supply
- Total supply, verified (Y/N), chain
### Activity
- Recent transfer count (proxy for liquidity/usage)
### Concentration
- Qualitative holder spread (verified source / sampled counterparties)
### Read
- 2–3 sentences: is this an active, verifiable token or a thin/unverified one
### Sources
- Etherscan stats/account/contract endpoints
Anti-Rationalization Table
| Rationalization | Reality |
|---|---|
| "Unverified source = scam" | Unverified is a gap to flag, not a verdict. Pair with activity + concentration. |
| "100 transfers = healthy" | Count without counterparty spread says nothing about distribution. Note the limitation. |
| "Etherscan-only covers everything" | Only EVM. For BSC/Solana use the chain-equivalent explorer. |
Code Example
Token supply + verification status in one call:
curl -s "https://api.etherscan.io/api?module=stats&action=tokenSupply&contractaddress=0xdac17f958d2ee523a2206206994597c13d831ec7&apikey=$ETHERSCAN_KEY" | jq '.result'
# → "1063422977229699987405542112" (raw wei string)
Verification
- Token supply pulled from the chain-equivalent explorer.
- Contract verification status checked (source code length / CompilerVersion).
- Recent transfer activity sampled as an activity proxy.
- Holder concentration noted with explicit method limitation.
- Output follows the Token On-Chain template (Supply / Activity / Concentration / Read / Sources).