HyperEVM · Holders & tokens

Token security

Honeypot check: a buy, a transfer and a sell simulated on our node, taxes, owner powers, holders and LP, with a verdict.

GET https://api.femtos.xyz/v1/tokens/{address}/security

Parameters

Param	In	Example or values
`address`	path	`<evmToken>`
`layer`	query	`hyperevm`

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/tokens/<evmToken>/security?layer=hyperevm"

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Field	Type	Meaning
`verdict`	ok \| caution \| danger \| honeypot	honeypot: cannot sell, sell tax ≥ 90 % or transfers blocked; danger: a danger check; caution: a warn check
`reasons`	string[]	warn / danger findings, strongest first (at most 8)
`simulation`	object	{pool, amountIn, canBuy, canSell, canTransfer, buyTax, sellTax, transferTax, buyGas, sellGas, transferGas, revert, …}
`checks[]`	object	One per finding. id: can_buy, can_sell, can_transfer, buy_tax, sell_tax, transfer_tax, simulation, owner, ownership_reclaim, access_control, mintable, pausable, blacklist, whitelist, max_tx, max_wallet, trading_cooldown, trading_toggle, tax_modifiable, balance_modifiable, proxy, selfdestruct, external_call, verified_source, spam, top10_share, holders, creator_share, owner_share, liquidity_usd, lp_locked: {id, severity, value, message}
`holders`	object	{top10Share, top10EoaShare, totalHolders, creator, creatorShare, ownerShare}
`liquidity`	object	{usd, pools, mainPool}
`height`	int	Block the checks ran at
`asOf`	int	Unix ms of the report
`cached`	boolean	Served from the 60 s cache (ageMs old)
`billing`	heavy	heavy

Holders GET /v1/holders
Current balances of an ERC-20, largest first, with concentration.
Token registry GET /v1/coins
HyperEVM tokens with their HyperCore spot link and price.
Coin detail GET /v1/coins/{layer}/{id}
One token: its links across layers, the markets it trades on, its 5 largest holders.
Daily token volume GET /v1/volume
USD swap volume of a token per UTC day, both sides of every priced swap.
Token families GET /v1/token-families
Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks.
Family token holders GET /v1/token-families/{token}
Holders of one family token with balanceOf at the indexed head.
Spam tokens GET /v1/tokens/spam
Tokens the indexer flags as spam, left out of every list, and the latest flag changes.
Token metadata GET /v1/tokens
Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body.
Token overview GET /v1/tokens/{address}
One token across all its pools: price, FDV, market cap, liquidity, windows, holders, top pools.