Tools: Read

Balances, portfolio, token inspection, gas estimates, prices, transaction history, and bridge status. Domain-specific reads are co-located with their write tools.

inspect_token

Read-only token inspection (authorities, decimals, supply) to help evaluate risk for newly launched tokens.

Parameters

Prop

Type

Response

{
  "name": "Wrapped SOL",
  "symbol": "SOL",
  "decimals": 9,
  "supply": "549805996.47",
  "mint_authority": null,
  "freeze_authority": null,
  "warnings": []
}

Example

Args (Solana SPL mint):

{ "chain": "solana", "token": "So11111111111111111111111111111111111111112" }

Args (EVM ERC-20 contract):

{ "chain": "base", "token": "0x..." }

Notes

On Solana, Seashail returns mint authorities, freeze authorities, and warnings when they are present.
On EVM, Seashail attempts ERC-20 metadata and also detects common EIP-1967 proxy patterns.

get_defi_yield_pools

Fetch and filter DeFi yield pool metadata (best-effort) for agent research. Read-only; does not execute transactions.

Parameters

Prop

Type

Response

{
  "pools": [
    {
      "chain": "Ethereum",
      "project": "aave-v3",
      "symbol": "USDC",
      "tvl_usd": 1200000000,
      "apy": 3.42,
      "stablecoin": true,
      "il_risk": false
    }
  ],
  "count": 1
}

Example

{
  "chains": ["Ethereum", "Arbitrum", "Base"],
  "query": "aave",
  "min_tvl_usd": 10000000,
  "min_apy": 0,
  "stablecoin_only": true,
  "exclude_il_risk": true,
  "max_results": 20
}

Notes

chains filters by the upstream dataset's chain naming (for example Ethereum, Arbitrum, Base), which is different from Seashail's chain identifiers used for transactions.

get_balance

Query token balances for a wallet.

Parameters

Prop

Type

Response

{
  "balances": [
    {
      "chain": "solana",
      "token": "native",
      "symbol": "SOL",
      "balance": "1.5",
      "decimals": 9,
      "usd_value": 225.0
    }
  ]
}

Example

Args (use active wallet, default chains for current network mode):

{}

Args (specific chain + token list):

{
  "wallet": "my-wallet",
  "account_index": 0,
  "chain": "solana",
  "tokens": ["native", "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]
}

get_portfolio

Aggregate portfolio view with USD values across all wallets.

Parameters

Prop

Type

Response

{
  "total_usd": 5432.1,
  "holdings": [
    {
      "wallet": "my-wallet",
      "chain": "solana",
      "token": "native",
      "symbol": "SOL",
      "balance": "20.0",
      "usd_value": 3000.0
    }
  ]
}

Example

{
  "wallets": ["my-wallet"],
  "chains": ["solana", "base"]
}

get_token_price

Current USD price estimate for a token.

Parameters

Prop

Type

Response

{
  "chain": "solana",
  "token": "native",
  "symbol": "SOL",
  "price_usd": 150.0
}

Example

{ "chain": "solana", "token": "native" }

estimate_gas

Estimate gas/fees for a proposed send or swap.

Parameters

Prop

Type

Response

{
  "op": "send_transaction",
  "chain": "solana",
  "estimated_fee": "0.000005",
  "fee_token": "SOL",
  "fee_usd": 0.00075
}

Example

Args (Solana send):

{
  "op": "send_transaction",
  "chain": "solana",
  "to": "11111111111111111111111111111111",
  "token": "native",
  "amount": "0.01",
  "amount_units": "ui"
}

Args (EVM send):

{
  "op": "send_transaction",
  "chain": "base",
  "to": "0x...",
  "token": "native",
  "amount": "0.001",
  "amount_units": "ui"
}

Args (swap):

{
  "op": "swap_tokens",
  "chain": "solana",
  "token_in": "native",
  "token_out": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amount_in": "0.05",
  "slippage_bps": 100,
  "provider": "auto"
}

get_transaction_history

Return locally tracked transaction history (newest first) with optional filtering.

Parameters

Prop

Type

Response

{
  "transactions": [
    {
      "type": "send",
      "chain": "solana",
      "wallet": "my-wallet",
      "token": "native",
      "amount": "0.5",
      "to": "11111111111111111111111111111111",
      "tx_hash": "5xYz...",
      "timestamp": "2025-01-15T14:30:00Z",
      "usd_value": 75.0
    }
  ],
  "count": 1
}

Example

{
  "limit": 100,
  "wallet": "my-wallet",
  "chain": "solana",
  "type": "swap"
}

get_portfolio_analytics

Portfolio analytics computed from local transaction history: totals and USD volume breakdowns by type, chain, and day.

Parameters

Prop

Type

Response

{
  "total_transactions": 42,
  "total_usd_volume": 12500.0,
  "by_type": {
    "send": { "count": 20, "usd_volume": 5000.0 },
    "swap": { "count": 22, "usd_volume": 7500.0 }
  },
  "by_chain": {
    "solana": { "count": 30, "usd_volume": 9000.0 },
    "base": { "count": 12, "usd_volume": 3500.0 }
  },
  "by_day": [{ "date": "2025-01-15", "count": 5, "usd_volume": 1200.0 }]
}

Example

{
  "wallet": "my-wallet",
  "since_ts": "2025-01-01T00:00:00Z",
  "until_ts": "2025-01-31T23:59:59Z"
}

Notes

Analytics are computed from Seashail's local transaction ledger only (transactions executed through Seashail).
USD values are best-effort estimates recorded at transaction time.

{
  "bridge_id": "5xYz...",
  "provider": "wormhole",
  "status": "completed",
  "source_chain": "solana",
  "destination_chain": "ethereum",
  "token": "USDC",
  "amount": "100.0",
  "source_tx": "5xYz...",
  "destination_tx": "0xabc..."
}

Example

{
  "bridge_id": "5xYzABC123...",
  "bridge_provider": "wormhole"
}

Notes

Wormhole lookups use the public Wormholescan API (no API key required).
The bridge_id should be the transaction signature/hash from the initiating bridge transaction.

Tools: Read

On this page