three.ws Portfolio

Deep-dive on ONE asset across every agent wallet you own. Returns which wallets hold it, your `total_amount` and `total_usd`, the per-wallet `holdings`, the live `market` data (price, 24h/7d/30d change, market cap, volume, ATH) and a `chart` of price history over `days`. Use `id:"native"` for the chain’s base coin (SOL on solana, ETH on evm), otherwise the base58 SPL mint or the 0x contract address. Requires THREE_WS_SESSION. Read-only.

Time series of your total portfolio USD value, oldest point first, for charting performance over time. Returns `points` as { t (ISO timestamp), usd } pairs, drawn from snapshots persisted by get_portfolio_summary(snapshot:true) or the website. An empty `points` array means no snapshots have been captured yet in the window — take one with get_portfolio_summary(snapshot:true) to start the series. Requires THREE_WS_SESSION. Read-only.

Live aggregated portfolio for the agent wallets YOU own (resolved from your three.ws session). Returns `total_usd` across all wallets and a per-wallet breakdown — each with agent_id, agent_name, chain (solana | evm), address, the resolved .sol name when present, the native balance (SOL/ETH amount + USD), the SPL/ERC-20 token holdings (amount + USD), and that wallet’s USD subtotal. A wallet that failed to price carries `ok:false` and an `error` instead of throwing the whole call. Note: this is the live VALUE snapshot — realized PnL lives in get_trades_feed. Set `snapshot:true` to persist a point for the history chart. Requires THREE_WS_SESSION. Read-only.

The public feed of notable CLOSED positions across all three.ws agents, newest exit first — the canonical source of realized PnL on the platform. Each item carries the coin (mint, symbol, name), the trader (agent_id, agent_name, copier_count), entry_sol / exit_sol / realized_pnl_sol / realized_pnl_pct / multiple, where realized_pnl_pct and multiple are the whole position's return across every sell leg while entry_sol and exit_sol describe the remaining cost basis and the closing leg only, hold_seconds, exit_reason, the buy/sell signatures, and oracle conviction context when the coin was scored. Filter by `mint` to see every closed trade on one coin (the time window is ignored when a mint is set). Paginate with `cursor` = the previous response's `next_cursor`. No auth required — read-only live data.

Read live, on-chain balances for any Solana pubkey directly from the RPC: the native SOL balance plus every non-zero SPL token position (classic SPL and Token-2022), each with mint, raw amount, ui_amount, decimals, and which token program owns it. This is the raw on-chain truth (no USD pricing) — use it to confirm the agent’s own signing wallet before a send_transfer, or to check any address. No session required. Read-only.

BROADCASTS A REAL, IRREVERSIBLE SOLANA MAINNET TRANSACTION that moves funds out of the agent’s own wallet. Sends native SOL (omit `mint`, or set mint:"native") or any SPL token (pass its base58 `mint` — supplied at call time, e.g. the $THREE mint or any token you hold). Signs locally with the per-call `secret` (base58) or SOLANA_SECRET_KEY on the server; for a token it auto-creates the recipient’s associated token account when missing. Returns the confirmed signature, the moved amount, and a Solscan link. EXECUTION ACTION — pass confirm:true to proceed. Native sends are capped by MAX_SOL_PER_TX; the recipient must be in RECIPIENT_ALLOWLIST when one is configured.