Operations and recovery

Build an agent portfolio view across wallets and positions

Plan EVM and Solana wallet reads, follow resource cursors, and preserve partial results without double-counting receipt tokens or collateral.

Workflow

  1. Choose wallets and coverage

    Use planPortfolio with explicit EVM wallets and networks or with Solana wallet addresses. Include token balance scans only when needed. Inspect the returned coverage and exclusions before requesting balances. Add specific Solana subaccount indices once you have discovered them.

  2. Read pages independently

    Consume planned reads with the SDK readPlan helper or with the relevant resource endpoints. Retain each page’s wallet, network, position identity, observation time and cursor. When one provider times out, keep successful rows and label that provider unavailable. Never replace its previous balance with zero on a failed read.

  3. Separate assets, debt and receipts

    A vault share may represent underlying assets already included in another view. Perpetual account equity can already include collateral. Group amounts by economic position, keep liabilities visible, and show the source of any total. Refresh the underlying position before proposing a subsequent withdrawal or trade.

Inspect the supported portfolio inputs

curl -fsS "https://www.bitpont.com/api/v1/agent/tools/describe" \
  -H 'Content-Type: application/json' \
  -d '{"tool":"planPortfolio"}'

Tools in this guide

Open tool explorer

Related links