Guides & technical architecture
ForkFolio documentation
How ForkFolio connects read-only exchange feeds, indexes public wallets, values Convert swaps, slices P&L cutoffs, and protects sessions.
Read-only Binance API setup (Spot, Earn & Futures)
Generate an API key with Enable Reading permission only so ForkFolio can reconcile Spot, Flexible/Locked Earn, Convert swaps, and USD-M Futures safely.
- Create a dedicated Binance API key with Enable Reading enabled and trading/withdrawal permissions unchecked.
- Paste the key and secret inside ForkFolio Settings — credentials are encrypted server-side and never exposed back to the browser.
- ForkFolio reconciles Spot crypto + USDT liquidity + Flexible Earn + Futures margin into one unified equity figure.
- If USD-M Futures is not enabled on your Binance account, ForkFolio catches -2015 cleanly and continues syncing Spot and Earn.
Solana & Ethereum public wallet tracking
Add public SOL and ETH addresses to monitor native coins alongside SPL and ERC-20 tokens without connecting any wallet extension.
- Paste any public Solana base58 address or Ethereum 0x address in ForkFolio Wallets.
- ForkFolio queries public RPC endpoints and merges discovered tokens with CoinGecko market quotes.
- No wallet connection popups, message signatures, or seed phrases are ever requested.
P&L cutoff dates & zero-balance reset breakpoints
Measure realized and open returns from a fresh cycle date without deleting or altering your underlying historical trade log.
- Open the Cutoff Drawer to choose All Time (since 2020), a YTD calendar preset, or an auto-detected zero-balance breakpoint.
- ForkFolio applies the cutoff date purely at the summary calculation layer.
- Your historical spot trade and futures event records remain untouched.
Convert 1d kline pricing & USD-M Futures net P&L
Accurately cost-basis direct asset swaps and aggregate Futures realized profits, funding fees, and trading commissions.
- Convert swaps resolve historical execution value from the target token 1d Binance kline.
- Futures net P&L sums realizedPnl + fundingFees - commissions + insuranceClear.
- Spot Performance Visualizer plots cumulative deployed capital against live market value with Buy, Sell, and Convert pins.
httpOnly SSO, Hide Balances (***) & stale-safe caches
Authentication, screen-share masking, and cache resilience designed to keep accounts private and responsive.
- Single sign-on via auth.rajchandra.me issues httpOnly, Secure cookies scoped to .rajchandra.me with single-flight token refresh.
- Toggle Hide Balances at any time to mask fiat values as $*** while retaining quantities and ROI percentages.
- CoinGecko L1/L2 caching (60s fresh / 24h stale-on-error) and 30s+ safe polling prevent rate-limit lockouts and layout jitter.