API reference · Holders & tokens

Token transfers

ERC-20 Transfer events of one token, newest first.

  • Not on HyperCore: HyperCore has no ERC-20 Transfer logs: an account’s transfers are on the wallet page and in the hc.ledger stream

GET https://api.femtos.xyz/v1/transfers

Parameters

ParamInExample or valuesMeaning
layerqueryelysium (Elysium); hyperevm (HyperEVM)EVM layer
tokenquery<token>Token address (required without address)
limitquery20Rows
cursorquery(optional)Next page: `next_cursor` of the previous answer

Example

Elysium

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/transfers?layer=elysium&token=<token>&limit=20"

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/transfers?layer=hyperevm&token=<token>&limit=20"

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

Response fields

FieldTypeMeaning
rows[]object{block, t, tx, logIndex, from, to, amount, amountRaw}
rows[].amountdecimal | nullAmount in token units (null when the token decimals are unknown)
next_cursorstring | nullOpaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page

Next page: cursor = the next_cursor of the previous answer, the same on every list (pagination).

Related: Holders & tokens

  • 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.
  • Token across layers GET /v1/tokens/{address}/lifecycle Elysium, HyperCore, HyperEVM
    One token from its Elysium launch to its HyperEVM mirror, HyperCore spot and perps, each link proven or marked inferred.
  • 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 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.

More

Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog