工具：NFT

NFT 工具涵盖库存读取（仅 Solana）、直接转账，以及通过智能体提供的交易载荷进行交易市场交易。写入工具需要策略审批。支持的交易市场：Blur、Magic Eden、OpenSea、Tensor。

get_nft_inventory

列出钱包持有的 NFT 类 mint。目前仅支持 Solana。

参数

Prop

Type

响应

{
  "items": [
    {
      "chain": "solana",
      "mint": "ABC123...",
      "owner": "11111111111111111111111111111111"
    }
  ]
}

响应结构仅供参考，实际字段可能有所不同。

示例

{
  "chain": "solana",
  "limit": 100
}

注意事项

对于非 Solana 链，Seashail 目前返回 not_supported。EVM NFT 库存计划在未来版本中支持。
即使目前只支持 Solana，chain 参数仍为必填。

transfer_nft

转移 NFT。Solana 上使用 SPL 代币转账，EVM 上使用 ERC-721 safeTransferFrom。需要策略审批。

参数

Prop

Type

各链行为

使用 SPL 代币转账（精确转移 1 个代币）- 提供 mint 参数：Solana mint 公钥
如有需要，Seashail 会为接收方创建关联代币账户（ATA）- 诈骗黑名单同时适用于接收方和 mint 地址

使用 ERC-721 safeTransferFrom - 提供 contract 和 token_id 参数 - 代币 ID 必须为十进制字符串（例如 "1234"）- 广播前模拟交易 - 诈骗黑名单同时适用于接收方和合约地址

响应

{
  "chain": "solana",
  "signature": "5UfD...txid"
}

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

响应结构仅供参考，实际字段可能有所不同。

示例

{
  "chain": "solana",
  "to": "11111111111111111111111111111111",
  "mint": "So11111111111111111111111111111111111111112"
}

{
  "chain": "base",
  "to": "0xRecipientAddress",
  "contract": "0xContractAddress",
  "token_id": "1234"
}

注意事项

需要策略审批。交易可能被自动批准、需要确认或被阻止，取决于策略配置。
Solana 转账总是精确转移 1 个代币（NFT 数量）。
另见：NFT 指南

buy_nft

通过交易市场买入 NFT，执行交易载荷（智能体提供或从已配置的交易市场适配器获取）。需要策略审批。

参数

Prop

Type

各链载荷

提供 tx_b64：base64 编码的 VersionedTransaction 字节（未签名；Seashail 将签名）。 - 提供 allowed_program_ids：程序 ID 白名单（每条指令必须在此集合中）。 - 也可提供 asset 对象，由交易市场适配器获取交易载荷。 - Solana 交易市场交易载荷始终强制确认（无论策略如何都需要用户确认）。 - 通过策略审批后，交易会被签名并广播到 Solana。

提供 to：合约/接收方地址。 - 提供 data：0x 前缀调用数据（空时使用 0x）。 - 提供 value_wei：可选 ETH 价值，十进制字符串（默认 "0"）。 - 也可提供 asset 对象，由交易市场适配器获取交易载荷。 - 广播前会进行模拟。 - 诈骗地址黑名单适用于 to 地址。

响应

{
  "chain": "solana",
  "marketplace": "magic_eden",
  "signature": "5UfD...txid"
}

{
  "chain": "base",
  "marketplace": "opensea",
  "tx_hash": "0x..."
}

响应结构仅供参考，实际字段可能有所不同。

示例

{
  "chain": "solana",
  "marketplace": "magic_eden",
  "usd_value": 50,
  "tx_b64": "BASE64...",
  "allowed_program_ids": [
    "ComputeBudget111111111111111111111111111111",
    "11111111111111111111111111111111"
  ]
}

{
  "chain": "base",
  "marketplace": "opensea",
  "usd_value": 50,
  "to": "0x...",
  "data": "0x...",
  "value_wei": "0"
}

注意事项

需要策略审批。交易可能被自动批准、需要确认或被阻止，取决于策略配置和美元价值。
智能体或已配置的适配器必须构建交易载荷。Seashail 本身不构建交易市场交易载荷。
Solana 交易市场交易载荷始终强制确认（无论策略如何都需要用户确认）。
若既未提供载荷字段（tx_b64/to/data）也未提供 asset，Seashail 返回错误。
另见：NFT 指南

sell_nft

通过交易市场卖出 NFT，执行交易载荷（智能体提供或从已配置的交易市场适配器获取）。需要策略审批。

参数

与上方的 buy_nft 相同。三个交易市场工具（buy_nft、sell_nft、bid_nft）共享相同的参数集。

各链载荷

与上方的 buy_nft 相同。Solana 和 EVM 载荷格式详情参见“各链载荷”部分。

响应

{
  "chain": "solana",
  "marketplace": "tensor",
  "signature": "5UfD...txid"
}

{
  "chain": "ethereum",
  "marketplace": "blur",
  "tx_hash": "0x..."
}

响应结构仅供参考，实际字段可能有所不同。

示例

{
  "chain": "solana",
  "marketplace": "tensor",
  "usd_value": 100,
  "tx_b64": "BASE64...",
  "allowed_program_ids": [
    "TCMPhJdwDryooaGGZjYoHRlM2vvDXcAP2BW2hhBKRmb"
  ]
}

{
  "chain": "ethereum",
  "marketplace": "blur",
  "usd_value": 100,
  "to": "0x...",
  "data": "0x...",
  "value_wei": "0"
}

注意事项

卖出前使用 get_nft_inventory 查看持有的 NFT。
载荷构建、策略审批和强制确认行为参见 buy_nft 注意事项。
另见：NFT 指南

bid_nft

通过交易市场对 NFT 出价，执行交易载荷（智能体提供或从已配置的交易市场适配器获取）。需要策略审批。

参数

与上方的 buy_nft 相同。三个交易市场工具（buy_nft、sell_nft、bid_nft）共享相同的参数集。

各链载荷

与上方的 buy_nft 相同。Solana 和 EVM 载荷格式详情参见“各链载荷”部分。

响应

{
  "chain": "solana",
  "marketplace": "magic_eden",
  "signature": "5UfD...txid"
}

{
  "chain": "polygon",
  "marketplace": "opensea",
  "tx_hash": "0x..."
}

响应结构仅供参考，实际字段可能有所不同。

示例

{
  "chain": "solana",
  "marketplace": "magic_eden",
  "usd_value": 25,
  "tx_b64": "BASE64...",
  "allowed_program_ids": [
    "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K"
  ]
}

{
  "chain": "polygon",
  "marketplace": "opensea",
  "usd_value": 25,
  "to": "0x...",
  "data": "0x...",
  "value_wei": "0"
}

注意事项

载荷构建、策略审批和强制确认行为参见 buy_nft 注意事项。
另见：NFT 指南
另见：策略与审批

工具：NFT

目录