工具：永续合约
Hyperliquid 和 Jupiter Perps 上的行情数据、仓位和永续合约交易。
永续合约工具支持两个提供商：Hyperliquid（EVM 地址，主网和测试网）和 Jupiter Perps（Solana 地址，仅主网）。省略时默认使用 Hyperliquid。写入工具需要策略审批。
get_market_data
返回所选提供商的市场元数据。可返回所有市场或单个市场。
参数
Prop
Type
响应
{
"provider": "hyperliquid",
"markets": [
{
"coin": "BTC",
"mark_px": "64250.00",
"funding_rate": "0.0001",
"open_interest": "150000000"
}
]
}响应结构仅供参考，实际字段可能有所不同。
示例
{
"provider": "hyperliquid"
}{
"provider": "hyperliquid",
"market": "BTC"
}注意事项
- 如果 Hyperliquid API 暂时不可用，Seashail 可能返回缓存快照。
get_positions
返回所选提供商和钱包的当前持仓状态。
参数
Prop
Type
各场所行为
- 使用钱包的 EVM 地址 - 如果选定的钱包/账户没有 EVM 地址，调用失败 - 主网和测试网均可使用
- 使用钱包的 Solana 地址 - 仅主网（网络模式必须为主网）
响应
{
"provider": "hyperliquid",
"positions": [
{
"market": "BTC",
"side": "long",
"size": "0.5",
"entry_px": "63000.00",
"mark_px": "64250.00",
"unrealized_pnl": "625.00",
"leverage": 3
}
]
}响应结构仅供参考，实际字段可能有所不同。
示例
{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0
}{
"provider": "jupiter_perps",
"wallet": "my-wallet",
"account_index": 0
}open_perp_position
开设永续合约仓位。需要策略审批。
参数
Prop
Type
各场所行为
- 支持市价和限价单 - 支持 size_units："usd" 或 "asset" - 使用钱包的 EVM 地址 - 主网和测试网均可使用
- 仅支持市价单 - 仅支持 size_units："usd" - 使用钱包的 Solana 地址 - 仅主网（网络模式必须为主网）
响应
{
"provider": "hyperliquid",
"market": "BTC",
"side": "long",
"size": "100",
"size_units": "usd",
"leverage": 3,
"order_type": "market",
"signature": "0x...",
"status": "confirmed"
}响应结构仅供参考，实际字段可能有所不同。
示例
{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0,
"market": "BTC",
"side": "long",
"size": "100",
"size_units": "usd",
"leverage": 3,
"order_type": "market",
"slippage_bps": 50
}{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0,
"market": "ETH",
"side": "short",
"size": "50",
"size_units": "usd",
"leverage": 2,
"order_type": "limit",
"limit_px": "2500"
}{
"provider": "jupiter_perps",
"wallet": "my-wallet",
"account_index": 0,
"market": "SOL",
"side": "long",
"size": "50",
"size_units": "usd",
"leverage": 5,
"order_type": "market",
"slippage_bps": 50
}注意事项
- 需要策略审批——交易可能被自动批准、需要确认或被阻止，取决于策略配置和美元价值。
- Jupiter Perps 目前仅支持市价单和 size_units="usd"。
close_perp_position
平仓永续合约仓位。需要策略审批。
参数
Prop
Type
各场所行为
- 支持部分平仓（提供
size）或全部平仓（省略size）- 支持 size_units："usd" 或 "asset" - 使用钱包的 EVM 地址
- 仅支持全部平仓（省略
size）- 若省略side，Seashail 从持仓中推断 - 使用钱包的 Solana 地址 - 仅主网
响应
{
"provider": "hyperliquid",
"market": "BTC",
"side": "long",
"signature": "0x...",
"status": "confirmed"
}响应结构仅供参考，实际字段可能有所不同。
示例
{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0,
"market": "BTC",
"slippage_bps": 50
}{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0,
"market": "ETH",
"size": "0.5",
"size_units": "asset",
"slippage_bps": 50
}{
"provider": "jupiter_perps",
"wallet": "my-wallet",
"account_index": 0,
"market": "SOL",
"slippage_bps": 50
}注意事项
- 需要策略审批。
- Jupiter Perps 目前仅支持平仓整个仓位（省略
size）。 - 对于 Jupiter Perps，若省略
side，Seashail 会推断持仓是多头还是空头（如果有歧义则报错）。
place_limit_order
在永续合约平台下限价单（仅限 Hyperliquid）。需要策略审批。
参数
Prop
Type
响应
{
"provider": "hyperliquid",
"market": "BTC",
"side": "short",
"size": "50",
"size_units": "usd",
"leverage": 2,
"limit_px": "50000",
"order_id": 123456,
"status": "placed"
}响应结构仅供参考，实际字段可能有所不同。
示例
{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0,
"market": "BTC",
"side": "short",
"size": "50",
"size_units": "usd",
"leverage": 2,
"limit_px": "50000"
}注意事项
- 此工具仅在 Hyperliquid 上可用。
- 需要策略审批。
modify_perp_order
修改现有订单（实现为取消 + 新建订单）。仅限 Hyperliquid。需要策略审批。
参数
Prop
Type
响应
{
"provider": "hyperliquid",
"original_oid": 123456,
"new_order_id": 123457,
"market": "BTC",
"side": "short",
"size": "50",
"size_units": "usd",
"leverage": 2,
"limit_px": "51000",
"status": "modified"
}响应结构仅供参考，实际字段可能有所不同。
示例
{
"provider": "hyperliquid",
"wallet": "my-wallet",
"account_index": 0,
"oid": 123456,
"market": "BTC",
"side": "short",
"size": "50",
"size_units": "usd",
"leverage": 2,
"limit_px": "51000"
}注意事项
- 此工具仅在 Hyperliquid 上可用。
- 修改实现为取消原始订单后下新订单。
- 需要策略审批。