API reference · Bridges & wallets

Bridge stream

Elysium: Each state change of a HyperEVM ↔ Elysium movement, live.
HyperCore, HyperEVM: Each HyperCore ↔ HyperEVM transfer, initiated then completed.

WebSocket channel elysium.bridge on wss://api.femtos.xyz/v1/ws · WebSocket channel bridge.transfers on wss://api.femtos.xyz/v1/ws

Parameters

Param	In	Example or values	Meaning
`token`	filter	(optional)	Token: its HyperEVM address, or hype
`direction`	filter	`(empty)`, `to_child`, `to_parent` (Elysium); `(empty)`, `evm_to_core`, `core_to_evm` (HyperCore, HyperEVM)	to_child \| to_parent
`account`	filter	(optional)	Account of the bridge leg: 0x address or a named wallet's handle (HyperCore, HyperEVM)
`min_amount`	filter	(optional)	Minimum amount, token units (HyperCore, HyperEVM)

Elysium

{"op":"subscribe","channel":"elysium.bridge","filter":{}}

HyperCore, HyperEVM

{"op":"subscribe","channel":"bridge.transfers","filter":{}}

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

Field	Type	Meaning
`snapshot: true`	OrbitTransfer[]	last 50 movements (Elysium)
`data`	OrbitTransfer	one HyperEVM <-> Elysium movement in its new state (the evm_elysium row of GET /api/bridges): {status, detail, direction, chain, value, token, bridge_latency_ms} (Elysium)
`snapshot: true`	CoreEvmTransfer[]	last 50 transfers (HyperCore, HyperEVM)
`data`	CoreEvmTransfer	one HyperCore <-> HyperEVM transfer per state change, initiated then completed (the core_evm row of GET /api/bridges): {status, direction, token, account, system_address, amount, core, evm, matched_by, bridge_latency_ms, depositor, beneficiary, …} (HyperCore, HyperEVM)

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.
Swaps by wallet GET /v1/trades Elysium, HyperEVM
Every swap a wallet sent (or a pool’s, a token’s), newest first, filterable by token, side, size and time.
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 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.