API reference · Holders & tokens

Token across layers

One token from its Elysium launch to its HyperEVM mirror, HyperCore spot and perps, each link proven or marked inferred.

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

Parameters

Param	In	Example or values	Meaning
`address`	path	`<token>` (Elysium); `PURR` (HyperCore); `0xb88339cb7199b77e23db6e890353e22632ba630f` (HyperEVM)	Elysium / HyperEVM address, core:<index>, HyperCore token id, name or perp coin

Elysium

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/tokens/<token>/lifecycle"

HyperCore

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/tokens/PURR/lifecycle"

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/tokens/0xb88339cb7199b77e23db6e890353e22632ba630f/lifecycle"

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

Field	Type	Meaning
`stage`	string \| null	Last stage reached, in lifecycle order
`stages[]`	object	{stage, reached, exact, basis, at, observedAt, source, detail, note}
`addresses`	object	{elysium, hyperevm, hypercore, perps}
`links[]`	object	{from, to, relation, exact, basis, source, checks, note}
`conflicts`	string[]	Sources that disagree (e.g. Delivered vs the registry): the stage is then not exact
`unavailable`	string[]	Sources that could not answer
`fees`	object \| null	Exact fees of an Ascend pool from its events, by conservation (creator owed = on-chain creatorOwed*, checked on every testnet pool): {exact, source, coverage, token, quote, listing, bid, collects, lastCollectAt, usd, note}

Token registry GET /v1/coins Elysium, HyperCore, HyperEVM
HyperCore tokens with their HyperEVM contract and price.
Coin detail GET /v1/coins/{layer}/{id} Elysium, HyperCore, HyperEVM
One token: its links across layers, the markets it trades on, its 5 largest holders.
Token metadata GET /v1/tokens Elysium, HyperCore, HyperEVM
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} Elysium, HyperEVM
One token across all its pools: price, FDV, market cap, liquidity, windows, holders, top pools.
Holders GET /v1/holders Elysium, HyperCore, HyperEVM
Spot balances of a HyperCore token, largest first.
Perp holders GET /v1/holders HyperCore
Largest open positions of a perp, long and short.
Token families GET /v1/token-families Elysium, HyperEVM
Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks.
Family token holders GET /v1/token-families/{token} Elysium, HyperEVM
Holders of one family token with balanceOf at the indexed head.
Token transfers GET /v1/transfers Elysium
ERC-20 Transfer events of one token, newest first.
Token security GET /v1/tokens/{address}/security Elysium, HyperEVM
Honeypot check: a buy, a transfer and a sell simulated on our node, taxes, owner powers, holders and LP, with a verdict.
Spam tokens GET /v1/tokens/spam Elysium, HyperEVM
Tokens the indexer flags as spam, left out of every list, and the latest flag changes.