Data Sources
Exchanges, source availability, and returned data in Furge scripting.
Supported exchanges
Live means new events while the job runs. History means data that can be read in a historical script run.
| Exchange | Candles (OHLCV) | Trades | Orderbook | Volume delta | Open interest | Standalone @volumes@ |
|---|---|---|---|---|---|---|
| Hyperliquid | Live + history | Live | Live | Live | Live, perps only | Live + history |
| BULK | Live + history | Live | Live | Live | Live | Live + history |
| Nest pools | Live + indexed history | Live | No | Live, derived | No | Live + indexed history |
| Ascend and Montra markets | Live + indexed history | Live | No | Live, derived | No | Live + indexed history |
Indexed history requires a registered market, a supported interval, and a date range within the market's stored coverage. Contract market history supports data analysis. Swap and liquidity actions run live. See Execution for supported actions.
Live candles and volume delta are derived from trades. The separate volume source streams the total base quantity from indexed volume profiles. Auction lifecycle and settlement use separate feeds.
Choose a source
| Source | Selector example | Returned data |
|---|---|---|
| Candles | btc@candles@hyperliquidf:timeframe=60 | OHLC prices, volume, trade count, timestamps. |
| Trades | btc@trades@hyperliquidf | Execution price and base quantity. |
| Token launches | launches@ascend, launches@montra | New market, quote asset, and launch time. |
| Market info | btc@info@bulkf | Perpetual or launchpad market statistics. |
| Orderbook | btc@orderbook@hyperliquidf:depth=5 | Best-first bid/ask price and quantity levels. |
| Volume Delta | btc@vd@hyperliquidf | Batch delta and cumulative delta. |
| Open Interest | btc@oi@hyperliquidf | Outstanding interest and optional mark/notional. |
| Volumes | btc@volumes@hyperliquidf:timeframe=60 | Aggregate volume bars. |
For BULK, use bulkf instead of hyperliquidf. Hyperliquid Spot uses hyperliquid and an exact pair such as hype/usdc; Spot and outcomes have no perpetual OI. HyperLink execution reads Hyperliquid public data, not a separate HyperLink source.
Select a contract market
Open Markets in the scripting editor and copy the market's source. Nest uses a unique pool pair or a pool address. Ascend and Montra use the launched token's address on Elysium mainnet.
UBTC/USDC@trades@nest
<token-address>@trades@ascend
<token-address>@trades@montraRead history
Use a full selector, not history.source("trade"):
SOURCE = "btc@candles@hyperliquidf:timeframe=60"
def on_data(ctx, history):
records = history.source(SOURCE)
latest = history.source(SOURCE, 0)
previous = history.source(SOURCE, 1)| Call | Return |
|---|---|
history.source(SOURCE) | Retained list, oldest to newest; [] when empty. |
history.source(SOURCE, 0) | Newest record or None. |
history.source(SOURCE, 1) | Previous record or None. |
script["lookback"] bounds retention per source (minimum effective capacity: two). It does not fetch past ticks when a live job starts. Each read returns a copy. Guard None before reading fields and check lists before indexing.
Multiple sources and event timing
Declare startup selectors as literal strings or module-level constants. To add a live feed during a run, call ctx.subscribe and pass the returned handle to history.source.
ctx.source identifies the triggering feed. Startup selectors omit options. Dynamic feeds use their subscription handle. ctx.timestamp_ms gives the time of the triggering event; check the other feeds independently.
Next: Read-only examples · Execution · Monitoring.