Seashail

工具:读取

余额、投资组合、代币检查、燃料估算、价格、交易历史和跨链桥状态。特定领域的读取工具与其对应的写入工具一同记录。

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 按上游数据集的链命名过滤(例如 EthereumArbitrumBase),与 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


另见

  • 兑换指南 -- 使用读取工具进行价格检查和余额查询的兑换工作流
  • 发送指南 -- 使用余额和燃料估算的发送工作流
  • DeFi 指南 -- 使用收益池和借贷仓位读取的 DeFi 操作
  • 跨链桥接指南 -- 使用跨链桥状态追踪的跨链桥接工作流
  • 预测市场指南 -- 使用搜索和订单簿读取的预测市场工作流

目录