Files
wickra/examples/wasm/strategy_macd_adx.html
T
kingchenc 677ea37402 examples: migrate to the native data layer (drop ws/coder-websocket/jackson/jsonlite) (#316)
Stacked on #315 (the native Binance REST fetcher). Retarget to `main` once #315 merges.

Migrates the runnable examples off third-party data-I/O packages onto Wickra's
native data layer (`CandleReader`, `Resampler`, `BinanceFeed`, `fetch_*klines`).

## Third-party packages removed (the zero-dep selling point)
- **Node**: `ws` (live feed → BinanceFeed) — dropped from package.json + lockfile
- **Go**: `github.com/coder/websocket` — dropped from go.mod / go.sum (`go mod tidy`)
- **Java**: `jackson-databind` (live feed + REST fetch) — dropped from pom.xml
- **R**: `jsonlite` + `websocket` + `later` — dropped from the README notes

Each language's CSV loading now goes through `CandleReader`, manual resampling
through `Resampler`, the live feed through `BinanceFeed`, and (Java/R) the REST
download through the native fetcher.

## Verification
Ran the offline examples per language against the bundled data — backtest and
multi_timeframe produce identical output across Python / Node / Go / Java / R
(e.g. ATR(14) last 345.1010; 1h→5m resamples to 240 bars, →15m to 80 bars).

C# / C / WASM (stdlib-only, no third-party deps to remove) follow in this branch.

Note: the streaming `strategy_*` examples have pre-existing candle-indicator
runtime bugs (CI only syntax-smokes them); the CSV migration preserves their
shape and leaves those bugs for a separate fix.
2026-06-17 01:49:11 +02:00

195 lines
7.3 KiB
HTML

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Wickra WASM — MACD + ADX trend filter</title>
<style>
body { font-family: ui-sans-serif, system-ui, sans-serif; max-width: 760px; margin: 2rem auto; padding: 0 1rem; color: #1d1d1d; }
h1 { margin-bottom: .25rem; }
.meta { color: #666; margin-top: 0; }
table { border-collapse: collapse; width: 100%; margin-top: 1rem; font-variant-numeric: tabular-nums; }
th, td { border: 1px solid #ddd; padding: .5rem .75rem; text-align: right; }
th:first-child, td:first-child { text-align: left; }
th { background: #fafafa; }
code { background: #f4f4f4; padding: .1rem .25rem; border-radius: .2rem; font-size: .9em; }
label { display: inline-block; margin-right: .5rem; }
button { padding: .5rem 1rem; }
#status { margin-top: 1rem; color: #666; }
.note { margin-top: 1rem; color: #888; font-size: .9em; }
</style>
</head>
<body>
<h1>Wickra WASM — MACD + ADX trend filter</h1>
<p class="meta">
Long-only trend follower: enters on a MACD(12,26,9) histogram crossover up
while ADX(14) &gt; 20, exits on the opposite crossover, 0.1% fees. The
browser counterpart of <code>examples/python/strategy_macd_adx.py</code>,
<code>examples/node/strategy_macd_adx.js</code> and the Rust
<code>strategy_macd_adx.rs</code> — same loop, same summary.
</p>
<p>
<label>Dataset: <input type="text" id="path" value="../data/btcusdt-1h.csv" size="40" /></label>
<button id="go" disabled>Run strategy</button>
</p>
<p id="status">Loading WASM module…</p>
<table id="results" hidden>
<thead><tr><th>Metric</th><th>Value</th></tr></thead>
<tbody></tbody>
</table>
<p class="note" id="disclaimer" hidden>
NOTE: Educational example — fees, slippage, funding costs and tax effects
are simplified or omitted. Past performance is not indicative of future
results.
</p>
<script type="module">
import init, {
CandleReader, version, installPanicHook, MACD, ADX } from "../../bindings/wasm/pkg/wickra_wasm.js";
const FEE = 0.001;
const ADX_FLOOR = 20.0;
function parseCsv(text) {
// Native CandleReader: header validation, BOM/whitespace tolerance. No
// manual CSV parsing.
const candles = new CandleReader(text).read();
const cols = { timestamp: [], open: [], high: [], low: [], close: [], volume: [] };
for (const c of candles) {
cols.timestamp.push(c.timestamp);
cols.open.push(c.open);
cols.high.push(c.high);
cols.low.push(c.low);
cols.close.push(c.close);
cols.volume.push(c.volume);
}
return cols;
}
function signed(value, digits) {
return (value >= 0 ? "+" : "") + value.toFixed(digits);
}
function runStrategy(cols) {
const n = cols.close.length;
const macd = new MACD(12, 26, 9);
const adx = new ADX(14);
let inPosition = false;
let entryPrice = 0.0;
const closedTrades = [];
let equity = 1.0;
const equityCurve = [];
let prevHistSign = null;
for (let i = 0; i < n; i++) {
const price = cols.close[i];
const macdOut = macd.update(price);
const adxOut = adx.update(cols.high[i], cols.low[i], price);
const mtm = inPosition ? equity * (price / entryPrice) : equity;
equityCurve.push(mtm);
if (macdOut == null || adxOut == null) continue;
const histSign = macdOut.histogram > 0.0;
const crossUp = prevHistSign === false && histSign;
const crossDown = prevHistSign === true && !histSign;
prevHistSign = histSign;
if (!inPosition && crossUp && adxOut.adx > ADX_FLOOR) {
entryPrice = price;
equity *= 1.0 - FEE;
inPosition = true;
} else if (inPosition && crossDown) {
const tradeRet = price / entryPrice - 1.0;
closedTrades.push(tradeRet);
equity *= (1.0 + tradeRet) * (1.0 - FEE);
inPosition = false;
}
}
if (inPosition) {
const tradeRet = cols.close[n - 1] / entryPrice - 1.0;
closedTrades.push(tradeRet);
equity *= (1.0 + tradeRet) * (1.0 - FEE);
}
return summarise("MACD + ADX Trend Filter (1h, BTCUSDT)", cols.close[0], cols.close[n - 1], n, closedTrades, equity, equityCurve);
}
function summarise(name, firstPrice, lastPrice, bars, closedTrades, finalEquity, equityCurve) {
const buyHold = lastPrice / firstPrice;
const stratReturn = finalEquity - 1.0;
const bhReturn = buyHold - 1.0;
const wins = closedTrades.filter((r) => r > 0).length;
const losses = closedTrades.filter((r) => r < 0).length;
const best = closedTrades.length ? Math.max(...closedTrades) : 0.0;
const worst = closedTrades.length ? Math.min(...closedTrades) : 0.0;
const nT = closedTrades.length;
const meanRet = nT ? closedTrades.reduce((a, r) => a + r, 0) / nT : 0.0;
const varRet = nT > 1 ? closedTrades.reduce((a, r) => a + (r - meanRet) ** 2, 0) / (nT - 1) : 0.0;
const stddev = Math.sqrt(varRet);
const sharpe = varRet > 0 ? meanRet / stddev : 0.0;
let peak = equityCurve.length ? equityCurve[0] : 1.0;
let maxDd = 0.0;
for (const eq of equityCurve) {
if (eq > peak) peak = eq;
const dd = (peak - eq) / peak;
if (dd > maxDd) maxDd = dd;
}
return [
["Strategy", name],
["Bars", String(bars)],
["Trades", `${nT} (W${wins} / L${losses})`],
["Strategy return", `${signed(stratReturn * 100, 2)}%`],
["Buy & Hold return", `${signed(bhReturn * 100, 2)}%`],
["Excess over BH", `${signed((stratReturn - bhReturn) * 100, 2)}%`],
["Max drawdown", `${(maxDd * 100).toFixed(2)}%`],
["Per-trade Sharpe", `${sharpe.toFixed(2)} (mean ${signed(meanRet, 4)}, stddev ${stddev.toFixed(4)})`],
["Best / worst trade", `${signed(best * 100, 2)}% / ${signed(worst * 100, 2)}%`],
];
}
function render(rows) {
const tbody = document.querySelector("#results tbody");
tbody.innerHTML = "";
for (const [k, v] of rows) {
const tr = document.createElement("tr");
tr.innerHTML = `<td>${k}</td><td>${v}</td>`;
tbody.appendChild(tr);
}
document.getElementById("results").hidden = false;
document.getElementById("disclaimer").hidden = false;
}
async function run() {
const path = document.getElementById("path").value;
const status = document.getElementById("status");
status.textContent = `Fetching ${path}…`;
try {
const resp = await fetch(path);
if (!resp.ok) throw new Error(`HTTP ${resp.status} for ${path}`);
const cols = parseCsv(await resp.text());
status.textContent = `Running MACD + ADX over ${cols.close.length} bars…`;
await new Promise((r) => setTimeout(r, 0));
render(runStrategy(cols));
status.textContent = `Done — ${cols.close.length} bars.`;
} catch (err) {
status.textContent = `error: ${err.message || err}`;
}
}
document.getElementById("go").onclick = run;
init().then(() => {
installPanicHook();
document.getElementById("go").disabled = false;
document.getElementById("status").textContent = `Ready — wickra ${version()}. Click "Run strategy".`;
});
</script>
</body>
</html>