Skip to content

Wickra CopilotA local market copilot.

Grounded in real order-book, liquidation and funding microstructure โ€” not vibes. Derive hard facts with the Wickra core, then ask any LLM (or none). LLM-agnostic, offline-first, read-only.

Wickra Copilot

The context is JSON, not code โ€‹

A ContextSpec names the symbols to inspect, a lookback window and the facts to derive. The builder walks each symbol's feed and returns a stable, self-explaining MarketContext.

json
{
  "symbols": ["BTCUSDT"],
  "lookback": 20,
  "timeframe": "1m",
  "facts": ["price_move", "orderbook_imbalance", "liquidation_cluster", "funding_flip", "oi_change", "volatility_spike"]
}

Each Fact carries a signed value, a ranking magnitude, a timestamp and a ready-made human sentence (e.g. "BTCUSDT dropped -6.44% over the last 20 bars."), so the context explains itself before any LLM sees it.

Install โ€‹

The same copilot from every language โ€” native Rust, Python, Node.js and WASM, plus a C ABI for C, C++, C#, Go, Java and R.

pip install wickra-copilot

Grounding first, generation second โ€‹

Build the deterministic MarketContext from the feed, then hand it to the LLM of your choice โ€” or none. The command API returns the same bytes in every binding.

import json
from wickra_copilot import Copilot

spec = json.dumps({
    "symbols": ["BTCUSDT"],
    "lookback": 20,
    "facts": ["price_move", "liquidation_cluster", "funding_flip"],
})

copilot = Copilot(spec)
context = json.loads(copilot.command(json.dumps({"cmd": "build_context", "feeds": feeds})))
for fact in context["facts"]:
    print(fact["human"])

Built on the Wickra core โ€‹

Wickra Copilot is part of the Wickra ecosystem. Its facts are derived from the same typed microstructure feeds that wickra-core and wickra-exchange produce, so the copilot reasons over exactly the numbers a backtest or a live chart would see.

Wickra Copilot is a software library, not a trading system, and gives no financial advice โ€” use at your own risk.