API reference · NFTs

NFT transfers

Elysium: Transfers of a collection or one token, newest first.
HyperEVM: Transfers of a collection or one token, newest first. While HyperEVM syncs: the last 24 h or 7 d of indexed blocks.

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

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	EVM layer
`collection`	query	`<collection>`	Collection contract
`tokenId`	query	(optional)	One token
`limit`	query	`20`	Rows
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

Elysium

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

HyperEVM

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

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

Field	Type	Meaning
`layer`	string	Layer
`collection`	string	Collection
`tokenId`	string \| null	The token asked; null: the whole collection
`scope`	all \| 24h \| 7d	all: the whole history; 24h / 7d: the block window read (the token index is missing)
`fromBlock`	int \| null	First block read when scope is a window
`rows[]`	object	{block, t, tx, logIndex, batchIndex, collection, standard, kind, tokenId, amount, from, to, …}
`next`	string \| null	Deprecated (sunset 31 Jan 2027): use `cursor` / `next_cursor`.
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page
`syncing`	true	Present while the layer syncs: data only up to dataUntil
`dataUntil`	ms	Indexed head time while the layer syncs

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

Active NFT collections GET /v1/nfts/collections Elysium, HyperEVM
Collections with the most transfers over the last 1 h or 24 h.
NFT collection GET /v1/nfts/collections/{address} Elysium, HyperEVM
Metadata, tokens seen and 24 h activity of one collection.
Collection tokens GET /v1/nfts/tokens Elysium, HyperEVM
Tokens of a collection by id, with their owner and metadata URI.
NFTs of a wallet GET /v1/nfts/owned Elysium, HyperEVM
ERC-721 tokens owned and ERC-1155 balances of one address.