# Data Sources (/scripting-v2/furge/sources)



## Supported exchanges [#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](/scripting-v2/furge/nest)                                          | Live + indexed history | Live   | No        | Live, derived | No               | Live + indexed history |
| [Ascend and Montra markets](/scripting-v2/furge/sources/trades#elysium-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](/scripting-v2/furge/execution) for supported actions.

Live candles and volume delta are derived from trades. The separate [volume source](/scripting-v2/furge/sources/volumes) streams the total base quantity from indexed volume profiles. Auction lifecycle and settlement use separate feeds.

## Choose a source [#choose-a-source]

| Source                                                              | Selector example                        | Returned data                                    |
| ------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------ |
| [Candles](/scripting-v2/furge/sources/candles)                      | `btc@candles@hyperliquidf:timeframe=60` | OHLC prices, volume, trade count, timestamps.    |
| [Trades](/scripting-v2/furge/sources/trades)                        | `btc@trades@hyperliquidf`               | Execution price and base quantity.               |
| [Token launches](/scripting-v2/furge/sources/launches#launch-event) | `launches@ascend`, `launches@montra`    | New market, quote asset, and launch time.        |
| [Market info](/scripting-v2/furge/sources/launches#market-info)     | `btc@info@bulkf`                        | Perpetual or launchpad market statistics.        |
| [Orderbook](/scripting-v2/furge/sources/orderbook)                  | `btc@orderbook@hyperliquidf:depth=5`    | Best-first bid/ask price and quantity levels.    |
| [Volume Delta](/scripting-v2/furge/sources/vd)                      | `btc@vd@hyperliquidf`                   | Batch delta and cumulative delta.                |
| [Open Interest](/scripting-v2/furge/sources/oi)                     | `btc@oi@hyperliquidf`                   | Outstanding interest and optional mark/notional. |
| [Volumes](/scripting-v2/furge/sources/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 [#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.

```text
UBTC/USDC@trades@nest
<token-address>@trades@ascend
<token-address>@trades@montra
```

## Read history [#read-history]

Use a full selector, not `history.source("trade")`:

```python
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 [#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`](/scripting-v2/furge/sources/launches) 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](/scripting-v2/furge/examples) · [Execution](/scripting-v2/furge/execution) · [Monitoring](/scripting-v2/furge/monitoring).
