工具:读取
余额、投资组合、代币检查、燃料估算、价格、交易历史和跨链桥状态。特定领域的读取工具与其对应的写入工具一同记录。
inspect_token
只读代币检查(权限、小数位数、供应量),用于评估新上线代币的风险。
参数
Prop
Type
响应
{
"name": "Wrapped SOL",
"symbol": "SOL",
"decimals": 9,
"supply": "549805996.47",
"mint_authority": null,
"freeze_authority": null,
"warnings": []
}示例
参数(Solana SPL mint):
{ "chain": "solana", "token": "So11111111111111111111111111111111111111112" }参数(EVM ERC-20 合约):
{ "chain": "base", "token": "0x..." }注意事项
- 在 Solana 上,Seashail 会返回 mint 权限、冻结权限,以及存在时的警告信息。
- 在 EVM 上,Seashail 会尝试获取 ERC-20 元数据,并检测常见的 EIP-1967 代理模式。
get_defi_yield_pools
获取并过滤 DeFi 收益池元数据(尽力而为),供智能体研究使用。只读,不执行交易。
参数
Prop
Type
响应
{
"pools": [
{
"chain": "Ethereum",
"project": "aave-v3",
"symbol": "USDC",
"tvl_usd": 1200000000,
"apy": 3.42,
"stablecoin": true,
"il_risk": false
}
],
"count": 1
}示例
{
"chains": ["Ethereum", "Arbitrum", "Base"],
"query": "aave",
"min_tvl_usd": 10000000,
"min_apy": 0,
"stablecoin_only": true,
"exclude_il_risk": true,
"max_results": 20
}注意事项
chains按上游数据集的链命名过滤(例如Ethereum、Arbitrum、Base),与 Seashail 用于交易的chain标识符不同。
get_balance
查询钱包的代币余额。
参数
Prop
Type
响应
{
"balances": [
{
"chain": "solana",
"token": "native",
"symbol": "SOL",
"balance": "1.5",
"decimals": 9,
"usd_value": 225.0
}
]
}示例
参数(使用活跃钱包,当前网络模式的默认链):
{}参数(指定链 + 代币列表):
{
"wallet": "my-wallet",
"account_index": 0,
"chain": "solana",
"tokens": ["native", "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]
}get_portfolio
跨所有钱包的聚合投资组合视图,含美元价值。
参数
Prop
Type
响应
{
"total_usd": 5432.1,
"holdings": [
{
"wallet": "my-wallet",
"chain": "solana",
"token": "native",
"symbol": "SOL",
"balance": "20.0",
"usd_value": 3000.0
}
]
}示例
{
"wallets": ["my-wallet"],
"chains": ["solana", "base"]
}get_token_price
代币的当前美元价格估算。
参数
Prop
Type
响应
{
"chain": "solana",
"token": "native",
"symbol": "SOL",
"price_usd": 150.0
}示例
{ "chain": "solana", "token": "native" }estimate_gas
估算拟议发送或兑换操作的燃料/手续费。
参数
Prop
Type
响应
{
"op": "send_transaction",
"chain": "solana",
"estimated_fee": "0.000005",
"fee_token": "SOL",
"fee_usd": 0.00075
}示例
参数(Solana 发送):
{
"op": "send_transaction",
"chain": "solana",
"to": "11111111111111111111111111111111",
"token": "native",
"amount": "0.01",
"amount_units": "ui"
}参数(EVM 发送):
{
"op": "send_transaction",
"chain": "base",
"to": "0x...",
"token": "native",
"amount": "0.001",
"amount_units": "ui"
}参数(兑换):
{
"op": "swap_tokens",
"chain": "solana",
"token_in": "native",
"token_out": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount_in": "0.05",
"slippage_bps": 100,
"provider": "auto"
}get_transaction_history
返回本地追踪的交易历史(最新的排在前面),支持可选过滤。
参数
Prop
Type
响应
{
"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
}示例
{
"limit": 100,
"wallet": "my-wallet",
"chain": "solana",
"type": "swap"
}get_portfolio_analytics
从本地交易历史计算的投资组合分析:按类型、链和日期的总量及美元交易量明细。
参数
Prop
Type
响应
{
"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 }]
}示例
{
"wallet": "my-wallet",
"since_ts": "2025-01-01T00:00:00Z",
"until_ts": "2025-01-31T23:59:59Z"
}注意事项
- 分析仅基于 Seashail 的本地交易账本(通过 Seashail 执行的交易)。
- 美元价值是在交易时记录的尽力估算值。
get_lending_positions
完整文档参见工具:借贷。
get_bridge_status
只读跨链桥状态。当 bridge_id 为 Wormhole id 时使用 Wormholescan(无密钥);LayerZero 使用已配置的 DeFi 适配器。
参数
Prop
Type
响应
{
"bridge_id": "5xYz...",
"provider": "wormhole",
"status": "completed",
"source_chain": "solana",
"destination_chain": "ethereum",
"token": "USDC",
"amount": "100.0",
"source_tx": "5xYz...",
"destination_tx": "0xabc..."
}示例
{
"bridge_id": "5xYzABC123...",
"bridge_provider": "wormhole"
}注意事项
- Wormhole 查询使用公共 Wormholescan API(无需 API 密钥)。
bridge_id应为发起跨链桥交易的交易签名/哈希。
get_prediction_positions
完整文档参见工具:预测市场。
search_prediction_markets
完整文档参见工具:预测市场。
get_prediction_orderbook
完整文档参见工具:预测市场。
pumpfun_list_new_coins
完整文档参见工具:Pump.fun。
pumpfun_get_coin_info
完整文档参见工具:Pump.fun。