API reference · NFTs

Collection tokens

Tokens of a collection by id, with their owner and metadata URI.

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

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	EVM layer
`collection`	query	`<collection>`	Collection contract
`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/tokens?layer=elysium&collection=<collection>&limit=20"

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/nfts/tokens?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
`tokens[]`	object	{tokenId, standard, owner, entity, uri, uriLength, firstSeenBlock, lastTransferBlock}
`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.
NFTs of a wallet GET /v1/nfts/owned Elysium, HyperEVM
ERC-721 tokens owned and ERC-1155 balances of one address.
NFT transfers GET /v1/nfts/transfers Elysium, HyperEVM
Transfers of a collection or one token, newest first. While HyperEVM syncs: the last 24 h or 7 d of indexed blocks.