add_wallet_address
ChatGPTTrack a wallet address for this account, so every other tool (balances, portfolio value, DeFi positions) starts covering it. Accepts a 0x EVM address or a .eth ENS name (resolved to an address before saving) on EVM chains, and a 64-hex Sui address on sui_mainnet. chain is one of 1 Ethereum, 56 BNB Chain, 8453 Base, 42161 Arbitrum, sui_mainnet Sui and defaults to 1 (Ethereum). Idempotent: re-adding an address already tracked on that chain returns the existing entry instead of duplicating it.
get_defi_position_history
ChatGPTHow the size of one DeFi position changed over the last 24h or 7d, as a series of USD values. Identify the position from a get_defi_positions row: address is the wallet, chain the position's chain id (a numeric EVM chain id, or sui_mainnet), protocol its protocolId and label its label. Values are the position's size at today's prices (the portfolio API does not reprice past states), so the curve shows deposits, withdrawals, accrued debt and rewards — not price moves. range is 24h (13 points · every 2h) or 7d (15 points · every 12h). Each point is one historical portfolio scan, so this call is slow (tens of seconds) — use it for one position at a time.
get_defi_positions
ChatGPTCross-chain DeFi positions (lending, staking, LPs, rewards) — lending markets, liquid staking, LP pools and more, across every chain the Sentio portfolio API covers (EVM chains for a 0x EVM address, Sui for a 64-hex Sui address). Pass address for one wallet, or pass no arguments to get the positions of every wallet you track in a single call. Each position carries its chain id.
get_portfolio_value
ChatGPTTotal USD value across every wallet address you track, broken down per address and chain.
get_token_balance_history
ChatGPTHow one wallet's balance of one token changed over the last 24h or 7d, as a series of points each carrying the amount held, the token's USD price at that instant and the resulting USD value. Identify the holding from a get_wallet_balances row: address is the wallet, chain its chain id (a numeric EVM chain id, or sui_mainnet), symbol the token symbol and token the contract address (omit token for an EVM chain's native coin; on Sui token is required — the coin type, SUI's included). range is 24h (13 points · every 2h) or 7d (15 points · every 12h). Each point is one historical portfolio scan, so this call is slow (tens of seconds) — use it for one holding at a time, not for every token in a wallet.
get_token_history_price
ChatGPTHistorical USD prices for one token at 1–100 requested timestamps, without a wallet or tracked holding. Identify the token by symbol (e.g. ETH, SUI) or address + chain (one of 1 Ethereum, 10 Optimism, 56 BNB Chain, 143 Monad, 8453 Base, 42161 Arbitrum, 43114 Avalanche, sui_mainnet Sui; contract address on EVM, coin type on Sui). Pass timestamps as ISO 8601 date-times with Z or a timezone offset. Returns available price samples with their actual timestamps, which may differ from the requested instants; check those timestamps before using a quote. Missing samples are omitted, and an empty prices array means no historical prices were found, never a zero price.
get_token_price
ChatGPTUSD spot price for a token, by symbol (e.g. ETH, SUI) or by token address + chain (one of 1 Ethereum, 56 BNB Chain, 8453 Base, 42161 Arbitrum, sui_mainnet Sui): a contract address on EVM chains, a coin type such as 0x2::sui::SUI on Sui.
get_wallet_balances
ChatGPTNative coin + token balances valued in USD, read from the Sentio portfolio API. address is a 0x EVM address, or a 64-hex Sui address for sui_mainnet. chain is one chain id or a list of them (each one of 1 Ethereum, 56 BNB Chain, 8453 Base, 42161 Arbitrum, sui_mainnet Sui; one wallet is either EVM or Sui, so a list stays within one of those). Pass address + one chain for that wallet on that chain; address + a list of chains for the same wallet on each of them in one call; address alone for every chain the wallet is tracked on (every 4 EVM chain, or Sui, when it is not tracked); or no arguments for every wallet address you track. Token addresses are contract addresses on EVM chains and coin types (0x…::sui::SUI) on Sui.
list_wallet_addresses
ChatGPTThe wallet addresses you track and the chain each is tracked on.
open_portfolio
ChatGPTOpen the portfolio as an interactive view beside the conversation: token balances and DeFi positions of every wallet address you track, with filters and per-holding history the user can explore. Use it when the user asks to open, show or explore their portfolio; use get_portfolio_value for a quick figure. Returns the same data as get_portfolio_value. In hosts without a side panel the view renders inline. Across every tracked wallet, each wallet is read from its latest stored portfolio sample (the Sentio API samples tracked wallets hourly): such an entry says source: "sample" and gives its time as asOf. A wallet without a recent sample, and any Sui wallet (its stored history covers fewer protocols), is scanned live (source: "live"). For one wallet's current state, ask for it by address. An aggregate answers within about 40 s: a wallet it could not re-read in time is answered from its last live read of the past 15 minutes when there is one (asOf says when), and otherwise comes back with pending: true, partial: true and no figures, and the total is marked partial. Its scan keeps running, so asking again in a minute usually returns it — do not report a pending wallet as empty. The Sentio portfolio API answers within about 25 s: when it stops a scan before reading everything, or a chain or protocol read fails (for example the wallet token-balance provider), the result (and each affected entry) carries partial: true and missing lists the chains and protocols not read. Its values are then incomplete and can be too low or too high (an unread position is left out; a debt left unpriced overstates a net value) — say so, and retry later or ask for fewer chains rather than reporting them as complete.
remove_wallet_address
ChatGPTStop tracking a wallet address for this account, so balances, portfolio value and DeFi positions no longer cover it. Accepts a 0x EVM address, a .eth ENS name (resolved before matching) or a Sui address. Pass chain (1 Ethereum, 56 BNB Chain, 8453 Base, 42161 Arbitrum, sui_mainnet Sui) to untrack the address on that chain only; omit it to untrack the address on every chain it is tracked on. Returns the removed entries; fails with "not tracked" when nothing matched. Only affects this account's own tracked-address list.