API reference · NFTs

NFTs of a wallet

ERC-721 tokens owned and ERC-1155 balances of one address.

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

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	EVM layer
`owner`	query	`<owner>`	Holder address
`limit`	query	`20`	Tokens listed

Elysium

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

HyperEVM

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

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

Field	Type	Meaning
`layer`	string	Layer
`owner`	string	Holder: 0x address, or a named wallet's handle
`entity`	object	Named wallet (labels), when known
`erc721`	int	ERC-721 tokens owned (counted up to 10,000)
`erc1155`	int	ERC-1155 token ids with a positive balance (up to 10,000)
`capped`	boolean	true: a count reached 10,000
`collections[]`	object	100 largest: {address, name, symbol, erc721, erc1155}
`tokens`	object[]	Tokens held, up to limit
`asOf`	ms	Time of `height` (indexed head the holdings include)
`height`	int	Head block of the layer the answer is cut at: every event up to it is counted (indexed head the holdings include)
`syncing`	true	Present while the layer syncs: data only up to dataUntil
`dataUntil`	ms	Indexed head time while the layer syncs

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.
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.