OPBT SDK · 10

FAQ

On this page

FAQ

Why does history() raise DataNotPrefetched?

Three usual causes: symbol spelling (Hyperliquid core markets use bare names while HIP-3 keeps its prefix, such as xyz:AAPL); the freq is not declared in extra_freqs; window × frequency exceeds the lookback_days warm-up.

Why is my fill slightly worse than the price I saw?

Backtest uses the frozen HISTORICAL_BAR_EXECUTION model: the next-decision bar open plus configured fees/slippage. Paper never uses that bar as a quote; submit-time fresh OnePort BBO determines its isolated simulated execution. Neither mode claims venue queue or fill equivalence.

on_funding never fires?

Backtest and Paper call it only for a recorded non-zero UPERP funding settlement. Live does not currently emit on_funding; use the available position and account fields when monitoring Live. Spot has no funding, and CPERP is not currently executable.

Are results reproducible?

Runs freeze the project version and dataset references so the inputs can be identified and reviewed. Exact repeatability also depends on the recorded engine and runtime environment.

Can my strategy access the network or files?

The strategy sandbox disables network access and uses a read-only root filesystem. Supported research data access is exposed through the ctx data APIs.