# RavingDesk

> Practise trading on paper: orders, ledger, risk, exposure and journal. No real money. RavingDesk is a free, local-first paper-trading desk: write market, limit and stop orders on a paper ticket, record hypothetical fills, track long and short positions at marks you enter with their source and date, size trades from a risk budget, check exposure and a portfolio shock, chart your own price observations and keep a trade journal. It also plans crypto spot round trips and Ethereum gas costs, and can show the ECB euro reference rates. It never connects to a broker, sends orders or holds money, and it is not financial advice.

RavingDesk (Paper trading workspace) is a premium app of usefulweb.app (https://usefulweb.app/): a full program that runs in the browser. Its engine is deterministic and the same functions are exposed as tools, so an agent can compute exactly what the app shows.

## Use it
- Landing page: https://ravingdesk.usefulweb.app/
- Workspace (browser app): https://ravingdesk.usefulweb.app/app - open a project with https://ravingdesk.usefulweb.app/app#project=<base64url-encoded project JSON> or a template with https://ravingdesk.usefulweb.app/app#template=<id>
- Project file format (JSON Schema): https://ravingdesk.usefulweb.app/project.schema.json
- Tutorials: https://ravingdesk.usefulweb.app/tutorials
- JSON API: POST https://ravingdesk.usefulweb.app/api/v1/tools/<toolId>/calculate (catalog: https://ravingdesk.usefulweb.app/api/v1/tools)
- OpenAPI: https://ravingdesk.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://ravingdesk.usefulweb.app/mcp

## Engine tools
- [RavingDesk Paper Portfolio & Exposure](https://ravingdeskpaperportfolio.usefulweb.app/): Turn paper fills and your own marks into positions, P&L, exposure and a price-shock check. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/ravingdesk-paper-portfolio/calculate · MCP tool `ravingdesk_paper_portfolio`
- [RavingDesk Position Size & Risk Planner](https://ravingdeskpositionsize.usefulweb.app/): Size a long or short paper trade from your risk budget, stop, target and round-trip fee. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/ravingdesk-position-size/calculate · MCP tool `ravingdesk_position_size`
- [RavingDesk Crypto Spot Round-Trip Cost Planner](https://ravingdeskcryptoroundtrip.usefulweb.app/): What a crypto spot buy-and-sell really costs: spread, slippage, fees, withdrawal and break-even. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/ravingdesk-crypto-round-trip/calculate · MCP tool `ravingdesk_crypto_round_trip`
- [RavingDesk Ethereum EIP-1559 Gas Fee Estimator](https://ravingdeskethgas.usefulweb.app/): Estimate an Ethereum transaction fee from gas used, base fee, max fee and priority tip (EIP-1559). API: POST https://ravingdesk.usefulweb.app/api/v1/tools/ravingdesk-eth-gas/calculate · MCP tool `ravingdesk_eth_gas`
- [Currency Converter](https://currencyconverter.usefulweb.app/): Convert an amount into several currencies at ECB euro reference rates, with rate date and source. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/currency-converter/calculate · MCP tool `currency_converter`
- [Historical FX Chart](https://historicalfxchart.usefulweb.app/): Chart exchange rates over time from ECB data: min, max, average, change, volatility and CSV export. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/historical-fx-chart/calculate · MCP tool `historical_fx_chart`
- [Gas Fee Intelligence Explorer](https://gasfeeintelligenceexplorer.usefulweb.app/): Live gas on 7 EVM chains: base fee, tips, trend and the USD cost of transfers and swaps. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/gas-fee-intelligence-explorer/calculate · MCP tool `gas_fee_intelligence_explorer`
- [Break-even Explorer](https://breakevenexplorer.usefulweb.app/): When does an investment pay for itself? Payback, NPV and IRR for solar, EVs, heat pumps… API: POST https://ravingdesk.usefulweb.app/api/v1/tools/break-even-explorer/calculate · MCP tool `break_even_explorer`
- [Percentage & Ratio Calculator](https://percentageratiocalculator.usefulweb.app/): X% of Y, % change, reverse %, percentage points, ratios and aspect ratios, with formulas. API: POST https://ravingdesk.usefulweb.app/api/v1/tools/percentage-ratio-calculator/calculate · MCP tool `percentage_ratio_calculator`

## Formats
- Import: RavingDesk workspace JSON (.ravingdesk.json), CSV of paper fills (date, symbol, side, quantity, price, fee), CSV of price observations (date, symbol, price, source)
- Export: RavingDesk workspace JSON, CSV: fills, orders, positions, price history, journal, Desk report (Markdown, print/PDF), Price chart (SVG, PNG), Share link (#project=)

## Limits
- Paper trading only: no broker or exchange connection, no live market data, no real orders or transactions.
- Calculations are illustrative and omit taxes, financing, borrow costs, dividends, corporate actions and margin requirements. They are not investment advice.
- Positions use weighted-average cost in one account currency; fills are replayed in the order entered, not by date, and multi-currency portfolios are not converted.
- Paper orders never monitor prices or execute automatically; only full fills are supported and stop triggers are not verified.
- Marks, chart prices, crypto prices, fee rates and gas inputs are entered by you and cannot be verified by the app.
- ECB reference rates are published once per working day and may be cached or delayed; availability depends on the ECB.
- Browser storage can be cleared; workspace files and share links are not encrypted.