# Volume Delta (/scripting-v2/furge/sources/vd)



## Returned record [#returned-record]

Illustrative direct-feed values. Prices use the market's quote asset per base asset, and timestamps use Unix milliseconds.

```json
{
  "t": 1793232000000,
  "value": 2.25,
  "delta": -0.25,
  "cumulative_delta": 2.25
}
```

| Field | Type | Meaning |
| --- | --- | --- |
| `t` | integer | Unix timestamp in milliseconds. |
| `value` | number | Current normalized cumulative value. |
| `delta` | number, optional | Latest standalone trade-batch delta. |
| `cumulative_delta` | number, optional | Standalone running delta. |

## Configure the feed [#configure-the-feed]

```python
SOURCE = "btc@vd@hyperliquidf"
```

Use `bulkf` for BULK. Direct volume delta is derived from live trades, including Nest and Montra. Omit `timeframe` and `bucket`. There is no direct historical VD backtest adapter.

`delta` is the latest batch's buy base quantity minus sell base quantity. `value` equals the running `cumulative_delta`, which starts at zero for the stream session, not a lifetime or 24-hour total.

```python
script = {"name": "watch-delta", "version": "2", "lookback": 2}
SOURCE = "btc@vd@hyperliquidf"


def on_data(ctx, history):
    sample = history.source(SOURCE, 0)
    if sample is not None:
        return {"metrics": {"delta": sample["delta"], "cvd": sample["value"]}}
```

An indexed read returns one dictionary or `None`; without an index it returns retained records oldest to newest. See [Read history](/scripting-v2/furge/sources#read-history).

[All Furge data sources](/scripting-v2/furge/sources) · [Monitoring](/scripting-v2/furge/monitoring).
