Reference

Tool Marketplace

The agent selects tools from this catalog based on user intent and remaining session budget. Each paid tool triggers an on-chain XLM payment and an SP1 purchase receipt proof.

Remittance Tools

Tool IDPriceDescription
validate_stellar_addressFREEChecks if a Stellar public key is valid and funded
remittance_fx_quote0.005 XLMQueries live FX rates from corridor providers, includes SDEX rate comparison
remittance_fee_estimate0.005 XLMEstimates total transfer cost (query fees + network fee)
remittance_execute_transferFREESubmits a user-signed XLM transfer on Stellar

Portfolio Analytics Tools

Tool IDPriceDescription
analysis_report0.165 XLMFull report: risk, stress, VaR, factors, Monte Carlo, rebalance, A–F grade
analysis_pretrade0.165 XLMPre-trade approval gate: current vs. proposed portfolio
analysis_risk0.005 XLMRisk metrics: Sharpe, Sortino, beta, volatility, drawdown
analysis_stress0.005 XLMStress test across 8+ scenarios (crash, stagflation, rate shock)
analysis_macro0.005 XLMMacro overlay with FRED-backed regime detection
analysis_rebalance0.005 XLMRebalance suggestions (profile, risk-parity, min-variance, equal-weight)

Budget Strategy

The agent maximizes information per XLM spent. When budget is low (<0.165 XLM), it prefers modular 0.005 XLM tools over expensive full reports. Free safety checks (address validation) are always run first.

Tool prices are defined in packages/shared as the single source of truth, shared between the web app and the worker.