API reference, Bridges & wallets
Wallet fills per bar
One wallet's fills on one market summed per bar: buys and sells with their average price, and the position after each bar.
- Elysium: not served
- HyperCore
- HyperEVM: not served
- Not on Elysium or HyperEVM: orders, fills and funding payments are HyperCore's: on the EVM layers an address swaps and holds tokens, see its trades, ERC-20 transfers and balances
GET https://api.femtos.xyz/v1/hypercore/wallet/{address}/fills/bars
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
address | path | 0xecc6be237833ebea8b2e57258c8c97ddd5afd692 | 0x address, or a named wallet's handle <entityId>.<hex> |
coin | query | BTC | Market (BTC, xyz:TSLA, @107) |
tf | query | 1s, 15s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M | Bar unit |
from | query | 1790812800000 | Start (ms, inclusive; aligned down to the unit). Without it: the `limit` bars ending at `to` |
to | query | 1792800000000 | End (ms, exclusive; default now) |
limit | query | (optional) | Bars at most from `from` (a window of at most 20,000 bars) |
Example
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/wallet/0xecc6be237833ebea8b2e57258c8c97ddd5afd692/fills/bars?coin=BTC&tf=1d&from=1790812800000&to=1792800000000"Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
bars[] | object | Ascending; only the bars with a fill: {t, buy, sell, position, liquidated} |
bars[].buy | object | Its buys in the bar; absent without one: {n, sz, usd, px, closedPnl, fee, feeToken} |
bars[].sell | object | Its sells in the bar; absent without one: {n, sz, usd, px, closedPnl, fee, feeToken} |
bars[].position | decimal | The account's position on the coin after the bar's last fill: that fill's start position plus (a buy) or minus (a sell) its size |
bars[].liquidated | boolean | A fill of the bar is a liquidation of this account |
from | ms | Start of the window read (aligned to the unit) |
to | ms | End of the window read (exclusive) |
asOf | ms | The fills' ingested head (Unix ms): every fill before it is in |
entity | object | Named wallet (labels), when known |
billing | heavy | heavy over 30 days |
Related: Bridges & wallets
- 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. - Wallet list stream WS wallets Elysium, HyperCore, HyperEVM
Every event of the three layers touching any of up to 100 addresses, in one subscription, each event tagged with its address. - HyperCore account GET /v1/hypercore/wallet/{address} HyperCore
One address's HyperCore account: perp value and margin, positions, spot balances. - Wallet open orders GET /v1/hypercore/wallet/{address}/orders HyperCore
One wallet's open orders: resting limit orders and trigger orders, on the main dex and every HIP-3 dex. - Wallet order history GET /v1/hypercore/wallet/{address}/orders/history HyperCore
One wallet's orders that left the book, newest first: how (filled, canceled, rejected) and why, the size filled and its average price. - Wallet fills GET /v1/hypercore/wallet/{address}/fills HyperCore
One wallet's HyperCore fills, newest first, with closed PnL, fees and the position before each. - Wallet funding GET /v1/hypercore/wallet/{address}/funding HyperCore
One wallet's funding payments, newest first: paid or received per perp and hour, with the position and the rate. - 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. - Wallet PnL GET /v1/wallet/{address}/pnl Elysium, HyperEVM
Any wallet on HyperEVM: per token balance, cost basis, realized and unrealized PnL, with 1d / 7d / 30d / all totals and win rate. - Portfolio value history GET /v1/wallet/{address}/value Elysium, HyperEVM
Any address on HyperEVM: its total USD value per 5 min (1d), hour (7d) or day (30d, all). - Wallet PnL curve GET /v1/hypercore/wallet/{address}/pnl HyperCore
One HyperCore wallet's PnL per hour or day: realized, fees, funding, net and cumulative, and its account value. - Wallet PnL stream WS pnl Elysium, HyperEVM
A wallet's positions and PnL on HyperEVM (GET /v1/wallet/{address}/pnl), pushed on subscribe, then the positions each block changes. - Was I sandwiched? GET /v1/wallet/{address}/mev Elysium
Every sandwich of a wallet’s swaps on Elysium: the bot, its two transactions, what the wallet lost. Free, no key. - 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 movements stream WS bridges.recent Elysium, HyperCore, HyperEVM
The GET /v1/bridges answer (movements newest first, 24 h stats), pushed on subscribe, then when a movement of the route changes state. - 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.
More
- This page as Markdown
- The whole API reference
- What HyperCore serves
- The whole API in one Markdown file
- OpenAPI 3.1 document
Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog