API reference · Bridges & wallets

Swaps by wallet

Every swap a wallet sent (or a pool’s, a token’s), newest first, filterable by token, side, size and time.

Not on HyperCore: swap history is EVM only; a HyperCore account's fills: POST /info userFills (Hyperliquid-compatible)

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

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	Layer
`trader`	query	`<creator>` (Elysium); `<evmWallet>` (HyperEVM)	History of a wallet (tx.from of the swaps); a named wallet's handle works too
`token`	query	(optional)	Swaps where this token is base or quote
`side`	query	`(empty)`, `buy`, `sell`	Buys or sells of the base
`minUsd`	query	(optional)	Smallest USD value (the indexer's, at the swap)
`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/trades?layer=elysium&trader=<creator>&limit=20"

HyperEVM

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

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

Field	Type	Meaning
`rows[]`	object	Newest first: {t, block, tx, logIndex, id, pair, protocol, base, quote, baseAddress, quoteAddress, side, …}
`coverage`	all \| priced	priced: a token of more than 20 pools, read through its priced swaps only (volume_usd set)
`scanned`	int	Index rows read for this page (filters apply to them: at most 1000 per source per call)
`spamHidden`	int	Rows of spam tokens left out (includeSpam=true shows them)
`next_cursor`	string \| null	Opaque cursor of the next page; null when nothing is left in the window. A filtered page can hold fewer rows than limit, even none: keep paging while next_cursor is not null

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

Cross-layer wallet GET /v1/wallet/{address} Elysium, HyperCore, HyperEVM
One address (or a named wallet's handle) on HyperCore, HyperEVM and Elysium, plus its latest events.
Wallet stream WS wallet Elysium, HyperCore, HyperEVM
Every event of the three layers touching one address.
Transfers by wallet GET /v1/transfers Elysium, HyperEVM
ERC-20 transfers sent and received by a wallet, newest first, filterable by token, direction, size and time.
Ledger stream WS hc.ledger HyperCore
Deposits, withdrawals, transfers and other non-trade balance moves.
Bridge movements GET /v1/bridges Elysium, HyperCore, HyperEVM
Matched HyperCore ↔ HyperEVM transfers with 24 h stats.
Bridge stream WS elysium.bridge · bridge.transfers Elysium, HyperCore, HyperEVM
Each HyperCore ↔ HyperEVM transfer, initiated then completed.
Bridge coverage GET /v1/bridges/coverage HyperCore, HyperEVM
Every HyperCore ↔ HyperEVM leg since our data starts, paired with its other leg: matched share per direction and token, why the others are not, latency.