{"name":"EveBrief Risk Oracle (ERO) methodology","methodology_version":"2026-11-13","schema_version":"1.5","changelog":"https://oracle.evebrief.org/changelog","scope":"On-chain risk check for EVM tokens and wallets, built for AI agents.","detects":[{"id":"rug_pull","level":"critical","what":"Rug pull proven on-chain: liquidity pulled to the token's deployer side and a money balance showing at least 0.02 ETH-equivalent of outside buyers' money taken (Ethereum, BSC, Base, Optimism)."},{"id":"rug_factory","level":"critical / high","what":"Documented rug factories: the treasury or collection hub tied to confirmed pulls (critical) and individually documented factory wallets such as pump bots and rotation wallets (high)."},{"id":"linked_wallets","level":"low","what":"Wallets linked to flagged tokens (deployer, funding source, beneficiary, hub, intermediary) and verdicts later disproven by the money balance stay visible as hints with a reason, never as verdicts."},{"id":"contract_red_flags","level":"low (deep=true)","what":"Live, read-only contract check on request: owner privileges such as mint, pause, blacklist, mutable fees or limits, mutable router, upgradeable proxy, trading gates. Raises the level to low at most from these flags alone; never proof of a rug pull."},{"id":"impersonation","level":"low","what":"Possible fakes and copycats: a token that uses the symbol of a CoinMarketCap top-100 token, or (with deep=true, read from the contract) the symbol and name of a listed token, but has a different address. Listed tokens are never flagged. A warning to check the address, not proof of fraud."},{"id":"listed_tokens","level":"unchanged (none without a finding)","what":"Publicly listed tokens (CoinGecko, CoinMarketCap, Superchain and Uniswap token lists, refreshed daily) are named with symbol and sources (label listed-token, evidence.listed; in the free preview as known). A listing never changes the level and is not a safety guarantee; ERO's own on-chain findings take precedence."},{"id":"known_infrastructure","level":"none","what":"Routers, pool managers, aggregators, bridges and stablecoins are recognised and not flagged, even when they appear in a money trail."}],"not_yet":{"note":"Planned, not part of any verdict today.","items":["Honeypot and buy/sell tax by simulation","Wash buyers and bot series (scripted fake demand)","Airdrop scams","Look-alike characters in fake names (homoglyphs)"]},"free_preview":{"endpoint":"https://oracle.evebrief.org/v1/preview","record_true_when":"risk is high or critical, i.e. an on-chain proven finding","returns":["record","chains","kind (token or wallet)","full_check (price and paid routes)"],"not_returned":"risk level, labels, reasons, evidence, findings, buyers' loss","note":"Heuristic signals (low) are not shown. record=false means no proven record, not that the address is safe.","rate_limit":"one shared limit for all requests; no IP or other identifier is stored"},"levels":{"critical":"The address is a token, deployer or beneficiary of a rug pull confirmed on-chain: liquidity was removed and the pulled funds went to the token's deployer, at least 0.02 ETH/WETH. Also the treasury of a documented rug factory tied to such confirmed pulls.","high":"Wallets of a documented rug factory (pump bots, rotation wallets), researched and listed individually.","low":"The address appears in the feed without a confirmed pull to the deployer (flagged token, its deployer, or an indirect link such as a funding source or hub). A hint, not a verdict.","none":"No record in the feed. This does not mean the address is safe."},"confirmed_pull":{"definition":"A liquidity removal event in the token's pool whose transaction was sent by the deployer, with at least the minimum amount on the ETH/WETH side.","min_eth":0.02,"deployer":{"base":"the address that made the first liquidity deposit into the pool","op":"the address that made the first liquidity deposit into the pool","eth":"the token contract creator"},"events":{"uniswap_v2":"Mint / Burn","uniswap_v3":"Mint / Burn (liquidity > 0)","uniswap_v4":"PoolManager Initialize / ModifyLiquidity (negative delta)","aerodrome":"Mint / Burn(address,address,uint256,uint256)","velodrome_v2":"Mint / Burn(address,address,uint256,uint256) (same as Aerodrome)","slipstream_velodrome_cl":"Mint / Burn (liquidity > 0), Uniswap V3 events"},"cross_check":"Rug pulls are checked against the beneficiary's ETH and WETH balance change in the pull transaction.","evidence":"For confirmed rugs the response lists the pull transactions (evidence.related_tokens[].pull_txs, with explorer links in pull_tx_urls). Verify: the transaction is sent by the deployer and removes liquidity from the token's pool."},"money_balance":{"applies_to":"eth and bsc (records that carry a money_balance block)","definition":"The scanner balances the money flows of all pools of the token (Uniswap v2/v3/v4, SushiSwap v2, PancakeSwap v2/v3; quote ETH/WETH, USDC, USDT): deposits and withdrawals of the deployer side, and the net amount outside buyers put in. The deployer side is the token creator, wallets the creator funded, and holders of the liquidity position (NFT or LP tokens) created in a deposit of the deployer side.","confirmed_if":"The deployer side removed liquidity and outside buyers lost at least min_eth to it (buyer_loss), or the deployer side sold more tokens than it had paid in and so took at least min_eth of buyers' money (rug by dump, label rug-by-dump, finding deployer_dump). Withdrawing one's own deposit is not a rug; panic selling by unrelated holders is not a rug either.","bsc":"History from an archive node. Deployer = sender of the first liquidity deposit; deployer side = deployer and holders of its LP tokens. Amounts are valued in USD and compared as ETH-equivalent. Launchpad bonding-curve tokens (no LP pool) are never rugs by liquidity pull.","not_a_rug":["the token still has a pool with at least 2,000 USD on the quote side","only the deployer's own money came back out","only trading fees were collected","liquidity was removed by unrelated liquidity providers"],"min_eth":0.02,"evidence":"related_tokens[].buyer_loss (eth, usd) and the removal transactions in pull_txs / findings.confirmed[].tx_hashes.","precedence":"If a record carries money_balance, it alone decides whether the pull is confirmed. A later money_balance record that disproves a rug withdraws the token's earlier records."},"coverage":{"confirmed":{"bsc":["pancakeswap_v2","pancakeswap_v3","uniswap_v2","uniswap_v3","biswap"],"base":["uniswap_v2","uniswap_v3","uniswap_v4","aerodrome","aerodrome_slipstream","pancakeswap_v3"],"op":["uniswap_v2","uniswap_v3","velodrome_v2","velodrome_cl"],"eth":["uniswap_v2","uniswap_v3","uniswap_v4","sushiswap_v2","pancakeswap_v2","pancakeswap_v3"]},"flagged_only":["polygon","arb","bsc pancakeswap infinity / uniswap_v4"],"money_balance":"On Ethereum, BSC, Base and Optimism a rug is confirmed only by a money balance (buyers' loss of at least 0.02 ETH-equivalent). A pool of an unknown exchange or quote token never clears a rug (verdict stays unchanged).","history_limit":{"op":"about 60 days; older pools cannot be balanced and keep their status"},"note":"The feed covers pools the scanner has observed (new pools above about 3,000 USD initial liquidity). It is not a complete list of all tokens."},"dead_launch":"Liquidity removed but less than the minimum ETH in total: recorded as dead launch / one-sided liquidity, stays low.","update_cadence":{"new_pools":"hourly","rug_checks":"every 3 hours","database_sync":"hourly"},"findings":{"confirmed":"Facts verified on-chain, each with at least one transaction hash and explorer link. Kinds: liquidity_pull_to_deployer, deployer_dump. A documented rug factory treasury is listed here only together with the confirmed rugs it received funds from (basis manual_forensics+on-chain).","signals":"Heuristic hints with basis (heuristic or manual_forensics), the evidence they rest on and why_not_proof. Signals alone never raise an address above low, except documented rug-factory wallets (high).","rule":"risk is critical only if findings.confirmed is not empty. Known public infrastructure stays none; findings.note explains why.","timestamps":"observed_at: scanner observation time (UTC). event_at: block time, null until recorded, never estimated.","truncated":"true if the address is linked to more tokens than listed (max 25)."},"indirect_links":"Funding sources, factory hubs and intermediary wallets are reported as hints and never raise an address above low. Public infrastructure (routers, bridges, exchanges) is listed as known-infrastructure.","limitations":["Heuristic indicators, not legal findings or investment advice.","A pull to an address other than the deployer is not counted as a rug: an ordinary liquidity provider exiting looks the same on-chain.","Results reflect the feed at the time of the call (see feed.latest_ts in the response)."]}