Documentation Index
Fetch the complete documentation index at: https://mintlify.com/backtest-kit/wallet-manager/llms.txt
Use this file to discover all available pages before exploring further.
All read-only commands are non-destructive — they fetch data from Binance and return it without placing, modifying, or canceling any orders. They are the right starting point before any manual trade: confirm the current price, verify your free USDT, and inspect open or recent orders before committing. fetchOrders and fetchPnl are cached; see the note at the bottom of this page for cache TTLs and how to bust them.
fetchPrice(symbol)
Returns the current average price for a symbol as a number, rounded to the exchange’s tick size. Internally calls binance.avgPrice() and formats the result through the PRICE_FILTER tick size for the symbol, so the returned number is always a valid limit-order price on that pair.
Caching: fetchPrice is not cached — every call hits binance.avgPrice() live. The PRICE_UPDATE_MS constant in the price module applies only to an internal ticker helper that is not used by this code path.
Parameters:
| Parameter | Type | Description |
|---|
symbol | string | Trading pair, e.g. "SOLUSDT" |
Promise<number>
repl => await wallet.walletPublicService.fetchPrice("SOLUSDT")
77.56
fetchFiat(symbol)
Returns the total USDT balance for the account — free plus locked — as a number. The symbol argument is used only for queue routing: it selects which per-symbol serialization queue the call runs through. The USDT balance itself is account-wide; passing any valid symbol returns the same value.
Parameters:
| Parameter | Type | Description |
|---|
symbol | string | Any valid trading pair (used for queue routing only) |
Promise<number>
repl => await wallet.walletPublicService.fetchFiat("SOLUSDT")
150.32
fetchBalance(symbol)
Returns the balance for the coin corresponding to symbol as { quantity, usdt }. The quantity field is the total coin balance including amounts locked in open orders (onOrder from the Binance account endpoint). The usdt field is quantity × current price from the live ticker.
Parameters:
| Parameter | Type | Description |
|---|
symbol | string | Trading pair whose base coin balance to return, e.g. "SOLUSDT" returns the SOL balance |
Promise<{ quantity: number; usdt: number }>
repl => await wallet.walletPublicService.fetchBalance("SOLUSDT")
{
"quantity": 2.5,
"usdt": 193.90
}
FETCH_BALANCE_FN function fetches balances for a fixed hardcoded symbol list. Only coins from these pairs are tracked:
BTC, POL, ZEC, HYPE, DOGE, SOL, PENGU, TRX, HBAR, NEAR, FARTCOIN, ETH, PUMP
fetchBalance for a symbol whose base coin is not in this list will throw because fetchBalance looks up the coin name in the returned map and throws if it is absent.
fetchOrders(symbol, limit?)
Returns recent orders for a symbol — including FILLED, CANCELED, and NEW (open) orders — as an IOrderData[] array. The result combines currently open orders (from binance.openOrders()) prepended in front of recently filled trade history (from binance.trades()), both sorted newest-first.
Parameters:
| Parameter | Type | Default | Description |
|---|
symbol | string | — | Trading pair, e.g. "SOLUSDT" |
limit | number | 25 | Maximum number of filled/canceled trades to include (open orders are always included regardless) |
Promise<IOrderData[]>
Caching: Cached for 10 minutes per symbol + limit combination.
Each element in the returned array has the following shape:
interface IOrderData {
symbol: string;
orderId: number;
status: "FILLED" | "CANCELED" | "NEW";
amount: string; // origQty — the original requested quantity
executedQty: string; // actual filled quantity
price: string; // fill price (from trade record) or limit price (for open orders)
time: string; // ISO 8601 timestamp
side: "BUY" | "SELL";
}
repl => await wallet.walletPublicService.fetchOrders("SOLUSDT", 10)
[
{
"symbol": "SOLUSDT",
"orderId": 4028571930,
"status": "NEW",
"amount": "0.25",
"executedQty": "0.00",
"price": "77.20",
"time": "2025-01-15T09:45:00.000Z",
"side": "SELL"
},
...
]
repl => fs.writeFileSync("orders.json", JSON.stringify(await wallet.walletPublicService.fetchOrders("SOLUSDT", 25), null, 2))
fetchPnl(symbol, limit?)
Returns a daily PnL estimate reconstructed from trade history and 1-hour OHLCV candles, as an IDailyPnL[] array sorted newest-first.
Parameters:
| Parameter | Type | Default | Description |
|---|
symbol | string | — | Trading pair, e.g. "SOLUSDT" |
limit | number | 25 | Number of filled trades to use as input (passed to fetchOrders internally) |
Promise<IDailyPnL[]>
Caching: Cached for 10 minutes per symbol + limit combination.
Each element in the returned array has the following shape:
interface IDailyPnL {
date: string; // ISO 8601 day (start of day)
pnl: string; // realized PnL for the day, in USDT, tick-size formatted
walletCost: string; // average cost basis of matched trades that day
amountQty: string; // cumulative coin balance at the end of the day
amountUSDT: string; // amountQty × VWAP (the day's volume-weighted average price)
averagePrice: string; // VWAP derived from 1-hour candles for the day
}
averagePrice for each day is the VWAP of all 1-hour candles within that calendar day, which is also used to convert the end-of-day coin balance into a USDT value.
repl => await wallet.walletPublicService.fetchPnl("SOLUSDT", 25)
[
{
"date": "2025-01-15T00:00:00.000Z",
"pnl": "3.42",
"walletCost": "74.10",
"amountQty": "2.5",
"amountUSDT": "193.90",
"averagePrice": "77.56"
},
...
]
repl => fs.writeFileSync("pnl.json", JSON.stringify(await wallet.walletPublicService.fetchPnl("SOLUSDT", 25), null, 2))
Cache TTLs. fetchOrders and fetchPnl are cached for 10 minutes per symbol + limit key. fetchPrice, fetchBalance, and fetchFiat are not cached — every call hits Binance live. After a commit* operation, walletPublicService automatically calls walletPrivateService.clear() to flush the orders and PnL caches, so the next read reflects the post-trade state. To flush the cache manually without placing a trade, call commitReload(symbol) — or call wallet.walletPrivateService.clear() directly to flush all symbols at once.