xxyy-trade

XXYY Trade

通过 XXYY Open API，在 Solana、Ethereum、BSC 和 Base 上进行链上代币交易和数据查询。

前置条件

使用前设置环境变量：

• XXYY_API_KEY（必填）——你的 XXYY Open API Key（格式：xxyy_ak_xxxx）。请在 https://www.xxyy.io/apikey 获取
• XXYY_API_BASE_URL（可选）——API 基础 URL，默认为 https://www.xxyy.io

身份验证

所有请求都需要以下标头：Authorization: Bearer $XXYY_API_KEY

安全须知

⚠ 首次使用前请阅读。 此技能会使用真实资金执行真实的链上交易。没有只读 API Key——同一个 Key 同时用于签署数据查询和交易。请将你的 XXYY_API_KEY 视同热钱包私钥。技能会在每个会话中的首次交易前显示一次风险确认；之后只需确认交易详情，让交易保持快捷。

• ⚠️ API Key = 钱包访问权限——你的 XXYY API Key 可以使用钱包余额执行真实的链上交易。如果 Key 泄露，任何人都能使用你的资金买卖代币。切勿分享、提交到版本控制中，或将其暴露在日志或公开渠道中。如果怀疑 Key 已泄露，请立即在 https://xxyy.io 重新生成。
• 托管式交易模式——XXYY 是一个托管式交易平台。你只需提供钱包地址（公钥）和 API Key。无需私钥或钱包签名——XXYY 会通过其平台代表你执行交易。
• 没有只读模式——数据查询（Feed、Token Query）和交易（Buy、Sell）使用同一个 API Key。目前没有单独的只读 Key。
• IP 白名单（推荐）——为提高安全性，请在 https://www.xxyy.io/apikey 为 API Key 配置 IP 白名单。只有列入白名单的 IP 才能调用 API。设置白名单前，请使用 get_ip 工具检查当前的出站 IP。

API 参考

严格限制：仅存在下方列出的端点。切勿猜测、推断或构造此处未明确记载的 URL。如果所需功能未在下方列出，请告知用户该功能不受支持。

完整端点列表：

• POST /api/trade/open/api/swap — 买入 / 卖出
• GET /api/trade/open/api/trade — 查询交易
• GET /api/trade/open/api/ping — Ping
• POST /api/trade/open/api/feed/{type} — Feed 扫描
• GET /api/trade/open/api/query — 代币查询
• GET /api/trade/open/api/wallets — 钱包列表
• GET /api/trade/open/api/wallet/info — 钱包信息
• GET /api/trade/open/api/pnl — PNL 查询
• GET /api/trade/open/api/trades — 交易历史
• GET /api/trade/open/api/ip — 获取 IP（不受 IP 白名单限制）
• GET /api/trade/open/api/kol-buy-list — KOL 买入列表
• GET /api/trade/open/api/tag-holder-buy-list — 标签持有者买入列表
• GET /api/trade/open/api/label-list — 标签列表（具有特定标签的代币）
• POST /api/trade/open/api/signal-list — 信号列表（AI 趋势信号）
• POST /api/trade/open/api/trending-list — 趋势列表（按周期筛选的热门代币，SOL/BSC）
• POST /api/trade/open/api/{chain}/launch — 发行代币（创建新代币）
• POST /api/trade/open/api/autoSell/createOrUpdate — 创建 / 更新自动卖出规则
• GET /api/trade/open/api/autoSell/list — 自动卖出规则列表
• GET /api/trade/open/api/autoSell/delete — 删除自动卖出规则
• GET /api/trade/open/api/autoSell/open — 切换自动卖出
• GET /api/trade/open/api/holders/{type} — 代币持有者列表

买入代币

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/swap

{
  "chain": "sol",
  "walletAddress": "<user_wallet>",
  "tokenAddress": "<token_contract>",
  "isBuy": true,
  "amount": 0.1,
  "tip": 0.0001,
  "slippage": 20
}

买入参数

参数	必填	类型	有效值	说明
chain	是	字符串	sol / eth / bsc / base	仅接受这 4 个值
walletAddress	是	字符串	SOL：Base58，32-44 个字符；EVM：0x+40 位十六进制字符	XXYY 平台上的钱包地址，必须与链匹配
tokenAddress	是	字符串	有效的合约地址	要买入的代币合约地址
isBuy	是	布尔值	true	买入时必须为 true
amount	是	数字	> 0	原生货币金额（SOL/ETH/BNB）
tip	是	数字	SOL：0.0001-0.1（单位：SOL）；EVM：0.1-100（单位：Gwei）	所有链通用的优先费。如果未提供，则回退到 priorityFee
slippage	否	数字	0-100	滑点容差百分比，默认值为 20
model	否	数字	1 或 2	1=防夹模式（默认），2=快速模式
priorityFee	否	数字	>= 0	仅适用于 Solana 链。除 tip 外的额外优先费

卖出代币

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/swap

{
  "chain": "sol",
  "walletAddress": "<user_wallet>",
  "tokenAddress": "<token_contract>",
  "isBuy": false,
  "amount": 50,
  "tip": 0.0001
}

卖出参数

参数	必填	类型	有效值	说明
chain	是	字符串	sol / eth / bsc / base	仅接受这 4 个值
walletAddress	是	字符串	SOL：Base58，32-44 个字符；EVM：0x+40 位十六进制字符	XXYY 平台上的钱包地址，必须与链匹配
tokenAddress	是	字符串	有效的合约地址	要卖出的代币合约地址
isBuy	是	布尔值	false	卖出时必须为 false
amount	是	数字	1-100	卖出百分比。例如：50 = 卖出持仓的 50%
tip	是	数字	SOL：0.0001-0.1（单位：SOL）；EVM：0.1-100（单位：Gwei）	所有链通用的优先费。如果未提供，则回退到 priorityFee
slippage	否	数字	0-100	滑点容差百分比，默认值为 20
model	否	数字	1 或 2	1=防夹模式（默认），2=快速模式
priorityFee	否	数字	>= 0	仅适用于 Solana 链。除 tip 外的额外优先费

tip / priorityFee 规则

• tip（必填）——所有链通用的优先费。EVM 链（eth/bsc/base）将 tip 用作优先费。如果未提供 tip，API 会回退到 priorityFee。
  • SOL 链：单位为 SOL（1 = 1 SOL，费用非常高）。建议范围：0.0001 - 0.1
  • EVM 链（eth/bsc/base）：单位为 Gwei。建议范围：0.1 - 100
• priorityFee（可选）——仅在 Solana 链上生效。Solana 支持同时使用 tip 和 priorityFee。

查询交易

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/trade?txId=<tx_id>

响应字段：txId、status（pending/success/failed）、statusDesc、chain、tokenAddress、walletAddress、isBuy、baseAmount、quoteAmount

交易历史

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/trades?walletAddress=<wallet>&chain=<chain>

分页查询特定钱包的成功交易记录。仅返回已完成的交易，并按创建时间排序（最新的在前）。

交易历史参数

参数	必填	类型	有效值	说明
walletAddress	是	字符串	钱包地址	必须属于当前 API Key 用户
chain	是	字符串	sol / eth / bsc / base	链标识符（必填）
tokenAddress	否	字符串	合约地址	按指定代币筛选
pageNum	否	int	>= 1	页码，默认值为 1
pageSize	否	int	1-20	每页条目数，默认值为 20

交易历史响应

{
  "code": 200,
  "data": {
    "pageNum": 1,
    "pageSize": 10,
    "total": 56,
    "list": [
      {
        "txId": "5xYz...",
        "status": 2,
        "statusDesc": "success",
        "chain": "sol",
        "tokenAddress": "EPjF...",
        "walletAddress": "5xYz...",
        "isBuy": 1,
        "baseAmount": 0.5,
        "quoteAmount": 1000,
        "createTime": "2026-03-18T10:00:00",
        "updateTime": "2026-03-18T10:00:05"
      }
    ]
  }
}

响应字段：txId、status（固定为 2=成功）、statusDesc、chain、tokenAddress、walletAddress、isBuy（1=买入，0=卖出）、baseAmount、quoteAmount、createTime、updateTime

Ping

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/ping

如果 API key 有效，则返回 "pong"。

Feed（扫描代币）

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/feed/{type}?chain={chain}

获取 Meme 代币列表：新上线、即将毕业或已毕业。

路径和查询参数

参数	必填	类型	有效值	说明
type	YES	路径字符串	NEW / ALMOST / COMPLETED	NEW = 新上线，ALMOST = 即将毕业，COMPLETED = 已毕业
chain	NO	查询字符串	sol / eth / bsc / base	默认值为 sol。支持全部 4 条链

请求体（筛选参数）

所有筛选条件均为可选。范围参数使用逗号分隔的字符串格式 "min,max"。将一侧留空即可仅设置最小值或最大值（例如，"100," = 最小值为 100，",50" = 最大值为 50）。

参数	类型	说明	示例
dex	string[]	DEX 平台筛选	参见下文“各链的 DEX 值”
quoteTokens	string[]	报价代币筛选	参见下文“各链的 quoteTokens 值”
link	string[]	社交媒体链接筛选	["x","tg","web"]
keywords	string[]	代币名称/符号关键词匹配	["pepe","doge"]
ignoreWords	string[]	忽略关键词	["scam"]
mc	string	市值范围（USD）	"10000,500000"
liq	string	流动性范围（USD）	"1000,"
vol	string	交易量范围（USD）	"5000,100000"
holder	string	持有者数量范围	"50,"
createTime	string	创建时间范围（距现在的分钟数）	"1,20"
tradeCount	string	交易次数范围	"100,"
buyCount	string	买入次数范围	"50,"
sellCount	string	卖出次数范围	"10,"
devBuy	string	开发者买入数量范围（原生代币）	"0.001,"
devSell	string	开发者卖出数量范围（原生代币）	"0.001,"
devHp	string	开发者持仓比例范围	",60"
topHp	string	前 10 名持仓比例范围	",60"
insiderHp	string	内部人士持仓比例范围	",50"
bundleHp	string	捆绑持仓比例范围	",60"
newWalletHp	string	新钱包持仓比例范围	",30"
progress	string	毕业进度百分比范围（仅限 NEW/ALMOST）	"1,90"
snipers	string	狙击者数量范围	",5"
xnameCount	string	Twitter 名称更改次数范围	",3"
tagHolder	string	监控钱包买入次数范围	"1,2"
kol	string	KOL 买入次数范围	"1,2"
dexPay	int	已付费的 DexScreener，1 = 仅筛选已付费项	1
oneLink	int	至少有一个社交链接，1 = 启用	1
live	int	当前正在直播，1 = 筛选直播项	1

各链的 DEX 值

• SOL：pump、pumpmayhem、bonk、heaven、believe、daosfun、launchlab、mdbc、jupstudio、mdbcbags、trends、moonshotn、boop、moon、time
• BSC：four、four_agent、bnonly、flap

各链的 quoteTokens 值

• SOL：sol、usdc、usd1
• BSC：bnb、usdt、usdc、usd1、aster、u

Feed 响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      {
        "tokenAddress": "...",
        "symbol": "TOKEN",
        "name": "Token Name",
        "createTime": 1773140232851,
        "dexName": "PUMPFUN",
        "launchPlatform": { "name": "PUMPFUN", "progress": "12.89", "completed": false },
        "holders": 3,
        "priceUSD": 0.000003046,
        "marketCapUSD": 3046.80,
        "devHoldPercent": 12.48,
        "hasLink": false,
        "snipers": 0,
        "quoteToken": "sol"
      }
    ]
  },
  "success": true
}

主要响应字段：tokenAddress、symbol、name、createTime、dexName、launchPlatform（名称/进度/是否已完成）、holders、priceUSD、marketCapUSD、devHoldPercent、hasLink、snipers、volume、tradeCount、buyCount、sellCount、topHolderPercent、insiderHp、bundleHp

代币查询

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/query?ca={contract_address}&chain={chain}

查询代币详情：价格、安全检查、税率、持有者分布等。

代币查询参数

参数	必填	类型	有效值	说明
ca	YES	string	合约地址	代币合约地址
chain	NO	string	sol / eth / bsc / base	默认值为 sol。支持全部 4 条链

代币查询响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "chainId": "bsc",
    "tokenAddress": "0x...",
    "baseSymbol": "TOKEN",
    "tradeInfo": {
      "marketCapUsd": 15464629.87,
      "price": 0.01546,
      "holder": 7596,
      "hourTradeNum": 20611,
      "hourTradeVolume": 2564705.05
    },
    "pairInfo": {
      "pairAddress": "0x...",
      "pair": "TOKEN - WBNB",
      "liquidateUsd": 581750.57,
      "createTime": 1772182240000
    },
    "securityInfo": {
      "honeyPot": false,
      "openSource": true,
      "noOwner": true,
      "locked": true
    },
    "taxInfo": { "buy": "0", "sell": "0" },
    "linkInfo": { "tg": "", "x": "", "web": "" },
    "dev": { "address": "0x...", "pct": 0.0 },
    "topHolderPct": 25.14,
    "topHolderList": [
      { "address": "0x...", "balance": 98665702.34, "pct": 9.86 }
    ]
  },
  "success": true
}

响应分组：

• tradeInfo：marketCapUsd、price、holder、hourTradeNum、hourTradeVolume
• pairInfo：pairAddress、pair、liquidateUsd、createTime
• securityInfo：honeyPot、openSource、noOwner、locked
• taxInfo：buy、sell（百分比字符串）
• dev：address、pct
• topHolderPct 和 topHolderList：前 10 名持有者分布

钱包列表

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/wallets

查询指定链上当前用户的钱包列表（含余额）。

钱包参数

参数	必填	类型	有效值	描述
chain	否	string	sol / eth / bsc / base	默认值为 sol
pageNum	否	int	>= 1	页码，默认值为 1
pageSize	否	int	1-20	每页条目数，默认值为 20
tokenAddress	否	string	合约地址	返回每个钱包的代币持仓

钱包响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "totalCount": 3,
    "pageSize": 20,
    "totalPage": 1,
    "currPage": 1,
    "list": [
      {
        "userId": 12345,
        "chain": 1,
        "name": "Wallet-1",
        "address": "5xYz...abc",
        "balance": 1.523456789,
        "topUp": 1,
        "tokenBalance": null,
        "createTime": "2025-01-01 00:00:00",
        "updateTime": "2025-06-01 12:00:00",
        "isImport": false
      }
    ]
  },
  "success": true
}

响应字段：

• totalCount：钱包总数
• list[].chain：链代码（1=SOL、2=BSC、3=ETH、6=BASE）
• list[].name：钱包显示名称
• list[].address：钱包地址
• list[].balance：原生代币余额
• list[].topUp：1=置顶，0=普通
• list[].tokenBalance：代币持仓（仅在提供 tokenAddress 时出现）。包含 amount、decimals、uiAmount、uiAmountString
• list[].isImport：该钱包是否为导入的钱包

链代码

代码	链
1	SOL
2	BSC
3	ETH
6	BASE

钱包信息

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/wallet/info

查询单个钱包的详情（原生余额 + 可选的代币余额）。

钱包信息参数

参数	必填	类型	有效值	描述
walletAddress	是	string	钱包地址	EVM 链不区分大小写
chain	否	string	sol / eth / bsc / base	默认值为 sol
tokenAddress	否	string	合约地址	返回该代币的持仓

钱包信息响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "address": "5xY...abc",
    "name": "MyWallet",
    "chain": 1,
    "isImport": false,
    "topUp": 0,
    "balance": 1.234567,
    "tokenBalance": {
      "amount": "1000000",
      "uiAmount": 1.0,
      "decimals": 6
    }
  },
  "success": true
}

响应字段：

• address：钱包地址
• name：钱包显示名称
• chain：链代码（1=SOL、2=BSC、3=ETH、6=BASE）
• balance：原生代币余额
• topUp：1=置顶，0=普通
• isImport：该钱包是否为导入的钱包
• tokenBalance：仅在提供 tokenAddress 时出现。包含 amount、uiAmount、decimals

PNL 查询

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/pnl?walletAddress=<wallet>&tokenAddress=<token>&chain=<chain>

查询特定钱包与代币组合的 PNL（盈亏）数据。返回买入/卖出总额、当前持仓，以及以原生货币和 USD 计价的利润。涵盖最近 30 天的数据。

PNL 查询参数

参数	必填	类型	有效值	描述
walletAddress	是	string	钱包地址	必须属于当前 API Key 用户
tokenAddress	是	string	合约地址	代币合约地址
chain	是	string	sol / eth / bsc / base	链标识符（必填）

PNL 查询响应

{
  "code": 200,
  "data": {
    "wallet": "5xYz...",
    "tokenMint": "EPjF...",
    "balance": 1.5,
    "buy": 2.0,
    "sell": 0.8,
    "hold": 1.2,
    "pnl": 0.5,
    "pnlusd": 75.0,
    "holdTokenNum": 1000,
    "holdTokenPercent": 0.05,
    "lastTradeTime": 1710000000000,
    "meta": {
      "symbol": "TOKEN",
      "dexId": "raydium",
      "pairAddress": "xxx"
    }
  }
}

响应字段：

• wallet：钱包地址
• tokenMint：代币合约地址
• balance：原生代币余额（例如 SOL）
• buy：买入总额（原生货币）
• sell：卖出总额（原生货币）
• hold：当前持仓价值（原生货币）
• pnl：利润/亏损（原生货币）
• pnlusd：利润/亏损（USD）
• holdTokenNum：当前代币持仓数量
• holdTokenPercent：持仓占总供应量的百分比
• lastTradeTime：最后交易时间戳（毫秒）
• meta.symbol：代币符号
• meta.dexId：DEX 标识符
• meta.pairAddress：交易对地址

获取 IP

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/ip

获取此服务当前的出站 IP 地址。可用此接口查看需要添加到 API Key 白名单的 IP。此接口不受 IP 白名单限制——即使 IP 未加入白名单，也可以正常使用。

无需参数。

获取 IP 响应

{
  "code": 200,
  "data": {
    "ip": "203.0.113.42"
  },
  "success": true
}

响应字段：

• ip：当前的出站 IP 地址

KOL 买入列表

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/kol-buy-list?chain={chain}

获取 KOL（关键意见领袖）近期买入列表。显示有影响力的交易者近期购买的代币。

KOL 买入列表参数

参数	必填	类型	有效值	描述
chain	否	字符串	sol / eth / bsc / base	默认值为 sol。支持全部 4 条链

KOL 买入列表响应

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "tokenMeta": {
        "symbol": "TOKEN",
        "dexId": "pump",
        "dexIcon": "https://...",
        "imageUrl": "https://...",
        "pairAddress": "PairAddress...",
        "mint": "TokenMintAddress..."
      },
      "priceNative": 0.0000001,
      "priceUsd": 0.0000085,
      "marketCap": 8500.0,
      "priceChange24h": 15.0,
      "walletBuyCnt": 2,
      "lastTradeTime": 1711234567890,
      "holder": 120,
      "volumeNative": 5000.0,
      "volumeUSD": 5000.0,
      "walletBuyItemList": [
        {
          "wallet": "KolWalletAddress...",
          "walletName": "KOL Name",
          "walletBuyAmount": 1.5
        }
      ]
    }
  ]
}

响应字段：

• tokenMeta.symbol：代币符号
• tokenMeta.mint：代币合约地址
• tokenMeta.dexId：DEX 标识符
• tokenMeta.pairAddress：交易对地址
• tokenMeta.imageUrl：代币 Logo URL
• priceNative：以原生货币计价的价格
• priceUsd：以 USD 计价的价格
• marketCap：以 USD 计价的市值
• priceChange24h：24 小时价格变动百分比
• walletBuyCnt：买入该代币的 KOL 钱包数量
• lastTradeTime：最近交易时间戳（毫秒）
• holder：持有者数量
• walletBuyItemList[].wallet：KOL 钱包地址
• walletBuyItemList[].walletName：KOL 钱包名称
• walletBuyItemList[].walletBuyAmount：以原生货币计价的买入金额

标签持有者买入列表

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/tag-holder-buy-list?chain={chain}

获取标签持有者（Smart Money、Whale 等）近期买入列表。显示带标签的钱包近期购买的代币。

标签持有者买入列表参数

参数	必填	类型	有效值	描述
chain	否	字符串	sol / eth / bsc / base	默认值为 sol。支持全部 4 条链

标签持有者买入列表响应

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "tokenMeta": {
        "symbol": "TOKEN",
        "dexId": "pump",
        "dexIcon": "https://...",
        "imageUrl": "https://...",
        "pairAddress": "PairAddress...",
        "mint": "TokenMintAddress..."
      },
      "priceNative": 0.0000001,
      "priceUsd": 0.0000085,
      "marketCap": 8500.0,
      "priceChange24h": -5.0,
      "walletBuyCnt": 1,
      "lastTradeTime": 1711234567890,
      "holder": 250,
      "volumeNative": 12000.0,
      "volumeUSD": 12000.0,
      "walletBuyItemList": [
        {
          "wallet": "HolderWalletAddress...",
          "walletName": "Smart Money",
          "walletBuyAmount": 2.5
        }
      ]
    }
  ]
}

响应字段：

• tokenMeta.symbol：代币符号
• tokenMeta.mint：代币合约地址
• tokenMeta.dexId：DEX 标识符
• tokenMeta.pairAddress：交易对地址
• tokenMeta.imageUrl：代币 Logo URL
• priceNative：以原生货币计价的价格
• priceUsd：以 USD 计价的价格
• marketCap：以 USD 计价的市值
• priceChange24h：24 小时价格变动百分比
• walletBuyCnt：买入该代币的带标签钱包数量
• lastTradeTime：最近交易时间戳（毫秒）
• holder：持有者数量
• walletBuyItemList[].wallet：持有者钱包地址
• walletBuyItemList[].walletName：持有者钱包名称／标签
• walletBuyItemList[].walletBuyAmount：以原生货币计价的买入金额

标签列表

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/label-list?chain={chain}&labelType={labelType}

获取带有指定标签的代币（例如标记为 AGENT_KOL 的代币）。

标签列表参数

参数	必填	类型	有效值	描述
chain	否	字符串	sol / eth / bsc / base	默认值为 sol。支持全部 4 条链
labelType	否	字符串	AGENT_KOL	默认值为 AGENT_KOL。目前仅支持 AGENT_KOL

标签列表响应

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "pairAddress": "PairAddress...",
      "dexId": "raydium",
      "dexName": "Raydium",
      "symbol": "TOKEN",
      "name": "Token Name",
      "tokenAddress": "TokenAddress...",
      "imageUrl": "https://...",
      "priceUSD": "0.00123",
      "marketCapUSD": "123456.78",
      "priceChange24H": "15.5",
      "launchFrom": "pump",
      "links": {
        "tg": "https://t.me/...",
        "x": "https://x.com/...",
        "web": "https://..."
      }
    }
  ],
  "success": true
}

响应字段：

• pairAddress：交易对地址
• dexId：DEX 标识符
• dexName：DEX 名称
• symbol：代币符号
• name：代币名称
• tokenAddress：代币合约地址
• imageUrl：代币 Logo URL
• priceUSD：当前 USD 价格
• marketCapUSD：以 USD 计价的市值
• priceChange24H：24 小时价格变动百分比
• launchFrom：发行平台
• links：社交媒体链接（Telegram、X/Twitter、网站）

信号列表

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/signal-list?type={type}&chain={chain}

获取 AI 趋势信号列表（例如，open-ai-trending 代币）。

信号列表参数

参数	必填	类型	有效值	描述
type	否	string	open-ai-trending	默认值为 open-ai-trending。目前仅支持 open-ai-trending
chain	否	string	sol / eth / bsc / base	默认值为 sol。支持全部 4 条链

请求体：空 JSON 对象 {}

信号列表响应

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "pairAddress": "PairAddress...",
      "dexId": "raydium",
      "dexName": "Raydium",
      "symbol": "TOKEN",
      "name": "Token Name",
      "tokenAddress": "TokenAddress...",
      "imageUrl": "https://...",
      "priceUSD": "0.00456",
      "marketCapUSD": "456789.12",
      "priceChange24H": "-5.2",
      "launchFrom": "pump",
      "links": {
        "tg": "https://t.me/...",
        "x": "https://x.com/...",
        "web": "https://..."
      }
    }
  ],
  "success": true
}

响应字段：与标签列表相同（见上文）

热门列表

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/trending-list?chain={chain}

获取趋势/热门代币列表，显示指定时间段内最活跃的代币。支持 SOL 和 BSC 链。

热门列表参数

参数	必填	类型	有效值	描述
chain	否	string	sol / bsc	默认值为 sol。仅支持 SOL 和 BSC
period	是	string	1M / 5M / 30M / 1H / 6H / 24H	热门数据的时间段。并非所有内部类别都支持所有时间段

请求体：

{ "period": "5M" }

热门列表响应

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "imageUrl": "https://...",
      "createTime": "1774581395318",
      "symbol": "TOKEN",
      "name": "Token Name",
      "dexId": "pfamm",
      "headerImage": "https://...",
      "pairAddress": "PairAddress...",
      "tokenAddress": "TokenMintAddress...",
      "priceUSD": "0.00005670",
      "priceChange24H": "98.00",
      "launchPlatform": {
        "name": "PUMP",
        "progress": 85,
        "completed": false,
        "launchedPair": null
      },
      "dexName": "Pump AMM",
      "dexIcon": "https://...",
      "marketCapUSD": "56708.41",
      "links": { "tg": "", "x": "https://x.com/...", "web": "" },
      "security": {
        "mintAuthority": { "value": false, "passed": true },
        "freezeAuthority": { "value": false, "passed": true },
        "topHolder": { "value": 18.61, "passed": false },
        "lpBurned": { "value": 100.0, "passed": true }
      },
      "holders": 641,
      "devHoldPercent": "0.0000000000000",
      "smartWallets": { "total": 3, "records": [{ "wallet": "...", "action": "buy", "nativeAmount": "1.5" }] },
      "sourceDexIcon": "https://...",
      "launchFrom": "pump",
      "extendFlags": { "live": false },
      "volume": 142092.91,
      "liquid": 20995.35,
      "buyCount": 2123,
      "sellCount": 1620,
      "auditInfo": {
        "devHp": 0,
        "snipers": 20,
        "insiderHp": 0,
        "newHp": 10.63,
        "bundleHp": 0,
        "dexPaid": true
      }
    }
  ]
}

响应字段：

• imageUrl：代币 Logo URL
• createTime：交易对创建时间戳（毫秒）
• symbol：代币符号
• name：代币名称
• tokenAddress：代币合约地址
• pairAddress：交易对地址
• priceUSD：当前美元价格
• priceChange24H：24 小时价格变化百分比
• marketCapUSD：美元计价的市值
• volume：交易量
• liquid：流动性
• buyCount：买入交易笔数
• sellCount：卖出交易笔数
• holders：持有者数量
• devHoldPercent：开发者持有比例
• dexName：DEX 池名称
• launchFrom：发行平台标识符
• launchPlatform：发行平台详情（名称、进度、是否完成、launchedPair）
• links：社交媒体链接（tg、x、web）
• security：安全信息 — mintAuthority、freezeAuthority（value=bool，passed=bool）、topHolder、lpBurned（value=number，passed=bool）
• smartWallets：智能钱包活动（总数 + 包含钱包、操作、nativeAmount 的近期记录）
• extendFlags.live：代币当前是否正在直播
• auditInfo：审计详情 — devHp（开发者持有比例）、snipers 数量、insiderHp、newHp（新钱包持有比例）、bundleHp、dexPaid（DexScreener 付费状态）

发行代币

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/{chain}/launch

发行（创建）新代币。可选择买入一定数量的新创建代币。

注意：API 层已取消链限制，但当前实现仅提供适用于特定链的选项：sol 的 solOptions 和 bsc 的 bscOptions。在添加相应选项之前，在 eth/base 上发行会在下游失败。

路径参数

参数	必填	类型	有效值	描述
chain	是	string	sol / eth / bsc / base	见上方注意事项

发行请求体

参数	必填	类型	描述
walletAddress	是	string	钱包地址（必须属于 API Key 的账户）
name	是	string	代币名称
symbol	是	string	代币符号
buyAmount	否	string	初始买入的原生代币数量。“0” = 仅创建。默认值：“0”
solOptions	仅限 Sol	object	Solana 链特定选项（见下文）
bscOptions	仅限 BSC	object	BSC 链特定选项（见下文）

buyAmount 限制：

• SOL：最多 100 SOL，最低余额 = buyAmount + 0.01 SOL
• BSC：最多 20 BNB，最低余额 = buyAmount + 0.015 BNB

solOptions (chain=sol)

Param	Required	Type	Default	Description
uri	YES	string	-	元数据 JSON URI（Metaplex 标准，包含名称/符号/描述/图片）
slippage	NO	integer	100	滑点，单位为基点。100 = 1%。仅当 buyAmount > 0 时生效
priorityFee	NO	long	100000	优先费，单位为 lamport
tipFee	NO	long	100000	小费，单位为 lamport
model	NO	integer	1	1 = MEV 保护，2 = 快速模式
creator	NO	string	null	创建者地址（base58）。默认为签名钱包
mayhemMode	NO	boolean	false	Pump 混乱模式
cashback	NO	boolean	false	Pump 返现

当 buyAmount > 0 时，会自动收取 1% 的平台费，且无法配置。

bscOptions (chain=bsc)

Param	Required	Type	Default	Description
desc	YES	string	-	代币描述
image	YES	string	-	图片 URL / base64 / data URI（≤5MB）
label	NO	string	"Meme"	类别：Meme、AI、Defi、Games、Infra、De-Sci、Social、Depin、Charity、Others
gasPrice	NO	string	null	自定义 gas 价格（wei）。未提供时自动获取
model	NO	integer	1	1 = MEV 保护（bundle），2 = 快速模式
feePlan	NO	boolean	false	费用方案开关
webUrl	NO	string	""	网站 URL
twitterUrl	NO	string	""	Twitter URL
telegramUrl	NO	string	""	Telegram URL
launchMode	NO	string	legacy	legacy 用于现有的 FourMeme 部署，openfour 用于 OpenFour 模板
templateId	OpenFour	string	-	OpenFour 模板 ID，launchMode=openfour 时必填
openFourParams	NO	object	null	符合 Schema 原生格式的 OpenFour 参数；服务会在可能时填入安全默认值
initParams	NO	object	null	高级选项：预编码的 OpenFour 模块参数。除非你了解 Schema 字节，否则请勿使用
antiSniperEnabled	NO	boolean	null	可选的 OpenFour 防狙击开关
tokenTaxInfo	NO	object	null	旧版 BSC 代币税配置（见下文）；不可与 OpenFour 混用

tokenTaxInfo（仅适用于旧版 BSC）

Param	Required	Type	Description
feeRate	YES	integer	交易费率。固定选项：1、3、5、10（表示 1%-10%）
burnRate	YES	integer	销毁率（0-100）
divideRate	YES	integer	分红分配率（0-100）
liquidityRate	YES	integer	流动性池比率（0-100）
recipientRate	YES	integer	接收方分配率（0-100）
minSharing	Conditional	long	参与分红所需的最小代币数量（单位为 ether）。divideRate > 0 时必填。格式：d × 10^n（n≥5，1≤d≤9）
recipientAddress	Conditional	string	接收方地址（0x...）。recipientRate > 0 时必填

约束： burnRate + divideRate + liquidityRate + recipientRate 必须等于 100。

BSC OpenFour 模板

Template ID	Name	MCP alias	Notes
1778027615723	Goplus SkillRoyalty	skillroyalty	税费/版税模板。费率以基点为单位；100 = 1%
1778027615724	Goplus Creator Incentives	creator_incentives	通常可使用服务默认值
1778027615725	Likwid Dex	likwid_dex	通常可使用服务默认值
1778027615728	Cubepeg	cubepeg	Node 服务会自动挖掘 hookSalt；调用方通常无需传入

openFourParams（BSC OpenFour）

参数	模板	类型	描述
buyFeeRate	SkillRoyalty	integer	买入手续费，以基点计。100 = 1%
sellFeeRate	SkillRoyalty	integer	卖出手续费，以基点计。100 = 1%
rateFounder	SkillRoyalty	integer	创始人手续费分成（0-100）
rateHolder	SkillRoyalty	integer	持有人手续费分成（0-100）
rateBurn	SkillRoyalty	integer	销毁手续费分成（0-100）
rateLiquidity	SkillRoyalty	integer	流动性手续费分成（0-100）
minShare	SkillRoyalty	string	最低份额阈值；请以字符串形式传入，以避免大数精度损失。服务默认值适用于常规发行
founder	SkillRoyalty	string	创始人的 EVM 地址；省略时默认为签名钱包
renderer	Cubepeg	string	可选的渲染器 EVM 地址；可使用零地址/默认值
hookSalt	Cubepeg advanced	bytes32	可选。留空即可，由 Node 自动挖掘有效盐值

OpenFour 注意事项：

• REST API 请求载荷使用嵌套的 bscOptions.* 字段。MCP launch_token 使用扁平的 bsc_* 字段，并会在调用 API 前将其转换为 REST 请求载荷。
• REST API 中的 launchMode 默认为 legacy。在 MCP 工具中，可以省略 bsc_launchMode；如果提供了受支持的 OpenFour 模板别名/ID，工具会自动推断为 OpenFour。
• 对于现有的 FourMeme 发行和旧版 tokenTaxInfo，请使用 legacy；仅当用户要求使用受支持的 OpenFour 模板之一时，才使用 OpenFour。不要将旧版 tokenTaxInfo 与 OpenFour 参数混用。
• buyAmount 会成为 OpenFour 的初始买入/预售报价，单位为 BNB。仅创建时使用 "0"，创建并初始买入时可使用 "0.001" 等值。
• 如果未提供 Cubepeg hookSalt，Node 服务会自动挖掘；仅在高级确定性部署时传入。
• SkillRoyalty 手续费率以基点计，而非百分比。buyFeeRate=100 和 sellFeeRate=100 表示买入/卖出手续费为 1%。如果覆盖分配比例，rateFounder + rateHolder + rateBurn + rateLiquidity 的总和必须等于 100。
• initParams 是用于已编码 OpenFour 模块参数的高级备用选项。常规集成请优先使用 openFourParams。

MCP launch_token BSC OpenFour 参数

这些是 MCP 工具参数，而非原始 REST 字段。MCP 服务会将它们映射到 bscOptions.launchMode、bscOptions.templateId、bscOptions.openFourParams 和 bscOptions.initParams。

MCP 参数	必填	类型	映射到 REST	描述
bsc_launchMode	否	enum	bscOptions.launchMode	legacy 或 openfour。可省略；提供受支持的模板时会自动推断为 OpenFour
bsc_openfourTemplate	否	enum	bscOptions.templateId	别名：skillroyalty、creator_incentives、likwid_dex、cubepeg
bsc_openfourTemplateId	OpenFour 必填	string	bscOptions.templateId	1778027615723、1778027615724、1778027615725、1778027615728 之一
bsc_openfour_antiSniperEnabled	否	boolean	bscOptions.antiSniperEnabled	可选的反狙击开关
bsc_openfour_renderer	仅限 Cubepeg	string	openFourParams.renderer	可选的 renderer EVM 地址
bsc_openfour_hookSalt	否	bytes32	openFourParams.hookSalt	高级 Cubepeg 盐值。省略后由 Node 服务自动挖掘
bsc_openfour_buyFeeRate	仅限 SkillRoyalty	integer	openFourParams.buyFeeRate	买入手续费，单位为 bps；100 = 1%
bsc_openfour_sellFeeRate	仅限 SkillRoyalty	integer	openFourParams.sellFeeRate	卖出手续费，单位为 bps；100 = 1%
bsc_openfour_rateFounder	仅限 SkillRoyalty	integer	openFourParams.rateFounder	创始人份额（0-100）
bsc_openfour_rateHolder	仅限 SkillRoyalty	integer	openFourParams.rateHolder	持有人份额（0-100）
bsc_openfour_rateBurn	仅限 SkillRoyalty	integer	openFourParams.rateBurn	销毁份额（0-100）
bsc_openfour_rateLiquidity	仅限 SkillRoyalty	integer	openFourParams.rateLiquidity	流动性份额（0-100）
bsc_openfour_minShare	仅限 SkillRoyalty	string	openFourParams.minShare	最低份额阈值；请以字符串形式传入
bsc_openfour_founder	仅限 SkillRoyalty	string	openFourParams.founder	创始人 EVM 地址；Node 服务默认使用签名钱包地址
bsc_openfourParamsJson	否	JSON 对象字符串	bscOptions.openFourParams	高级原始参数，会在带类型的 bsc_openfour_* 字段之前合并
bsc_openfourInitParamsJson	否	JSON 对象字符串	bscOptions.initParams	高级编码模块参数；除非已知 schema 字节，否则请勿使用

MCP OpenFour launch_token 示例

Cubepeg（1778027615728，hookSalt 自动挖掘）：

{
  "chain": "bsc",
  "walletAddress": "<BSC_WALLET>",
  "name": "Cube Token",
  "symbol": "CUBE",
  "buyAmount": "0.001",
  "bsc_desc": "OpenFour Cubepeg token",
  "bsc_image": "https://example.com/image.png",
  "bsc_label": "Meme",
  "bsc_model": 1,
  "bsc_feePlan": false,
  "bsc_launchMode": "openfour",
  "bsc_openfourTemplate": "cubepeg"
}

Likwid Dex（1778027615725）：

{
  "chain": "bsc",
  "walletAddress": "<BSC_WALLET>",
  "name": "Likwid Token",
  "symbol": "LIQ",
  "buyAmount": "0.001",
  "bsc_desc": "OpenFour Likwid Dex token",
  "bsc_image": "https://example.com/image.png",
  "bsc_label": "Meme",
  "bsc_model": 1,
  "bsc_feePlan": false,
  "bsc_launchMode": "openfour",
  "bsc_openfourTemplate": "likwid_dex"
}

Creator Incentives（1778027615724）：

{
  "chain": "bsc",
  "walletAddress": "<BSC_WALLET>",
  "name": "Creator Token",
  "symbol": "CRT",
  "buyAmount": "0.001",
  "bsc_desc": "OpenFour Creator Incentives token",
  "bsc_image": "https://example.com/image.png",
  "bsc_label": "Meme",
  "bsc_model": 1,
  "bsc_feePlan": false,
  "bsc_launchMode": "openfour",
  "bsc_openfourTemplate": "creator_incentives"
}

SkillRoyalty（1778027615723，1% 买入/卖出手续费）：

{
  "chain": "bsc",
  "walletAddress": "<BSC_WALLET>",
  "name": "Royalty Token",
  "symbol": "ROY",
  "buyAmount": "0.001",
  "bsc_desc": "OpenFour SkillRoyalty token",
  "bsc_image": "https://example.com/image.png",
  "bsc_label": "Meme",
  "bsc_model": 1,
  "bsc_feePlan": false,
  "bsc_launchMode": "openfour",
  "bsc_openfourTemplate": "skillroyalty",
  "bsc_openfour_buyFeeRate": 100,
  "bsc_openfour_sellFeeRate": 100,
  "bsc_openfour_rateFounder": 100,
  "bsc_openfour_rateHolder": 0,
  "bsc_openfour_rateBurn": 0,
  "bsc_openfour_rateLiquidity": 0,
  "bsc_openfour_minShare": "1"
}

启动响应

成功：

{
  "code": 200,
  "msg": "success",
  "data": {
    "txHash": "transaction hash or signature",
    "tokenAddress": "newly created token address",
    "success": true
  },
  "success": true
}

链上执行失败：

{
  "code": 200,
  "msg": "success",
  "data": {
    "txHash": "transaction hash or signature",
    "tokenAddress": null,
    "success": false
  },
  "success": true
}

启动错误代码

代码	消息	描述
8004	wrong_parameter	缺少必填字段或字段无效
8006	insufficient_balance	钱包余额低于最低要求
8060	api_key_invalid	API Key 无效
8062	api_key_rate_limited	超出 QPS 限制
8106	open_api_launch_chain_not_supported	不支持该链（仅支持 sol/bsc）
8107	open_api_launch_buy_amount_exceed	buyAmount 超出上限（SOL：100，BSC：20）
8108	open_api_launch_failed	Node 服务调用失败
9006	wallet_not_exists	未找到钱包或当前账户不拥有该钱包

启动说明

• 交易确认超时：SOL 约 25s，BSC 约 3-5s
• SOL uri 必须是可访问的 JSON 元数据 URL（Metaplex Token Metadata 标准）
• BSC 图片上传由 FourMeme 平台在内部处理
• BSC legacy 模式用于现有的 FourMeme 启动流程；BSC OpenFour 模式仅适用于四种受支持的 OpenFour 模板
• 提供 bsc_openfourTemplate 或 bsc_openfourTemplateId 时，可省略 MCP bsc_launchMode；否则 BSC 启动将保持 legacy 模式
• OpenFour 不使用 legacy tokenTaxInfo；应使用 openFourParams / MCP bsc_openfour_*
• SOL 铸造地址由服务随机生成
• 当 buyAmount > 0 时，SOL 平台费用（1%）会自动收取

执行规则

1. 写入前确认交易详情 -- 执行任何写入操作（/swap、/launch、/autoSell/*）前，请与用户确认：链、代币地址、数量/百分比、买入或卖出，以及使用哪个钱包。优先使用内联摘要；详情明确后，不要通过多轮往返提问阻碍用户。
   • 会话中的首次交易风险确认：在会话中的首次写入操作时，还需用一个简洁的信息块提醒用户主要风险 — API Key = wallet access、no read-only key exists、IP whitelist recommended — 并通过 AskUserQuestion 请用户确认一次。同一会话中的后续写入操作跳过此风险提示，仅确认交易详情，以提高效率。
2. 自动查询钱包 -- 如果用户未提供钱包地址： a. 如果该链有已记住的默认钱包，直接使用该钱包，并在确认前通过 Wallet Info API 显示其当前余额。 b. 否则，调用 List Wallets API。如果只有 1 个钱包，则自动选择。如果有多个，请用户选择。如果没有，则引导用户前往 https://www.xxyy.io/wallet/manager?chainId={chain} 创建钱包。 c. 将所选钱包记为该链的默认钱包。 d. 如果用户提供了钱包地址，请调用 Wallet Info API 验证该地址是否存在，并在确认交易前显示其余额。
3. 使用 Bash 和 curl 调用 API
4. 轮询交易结果 -- 提交 swap 后，以 5s 间隔最多查询交易状态 3 次
5. 显示交易链接 -- 始终显示包含 txId 的区块浏览器 URL
6. 绝不重试失败的 swap 请求 -- 应向用户显示错误
7. 链与钱包验证 -- walletAddress 必须与所选链匹配。Solana 钱包不能用于 BSC/ETH/Base 交易，反之亦然。如果用户提供的钱包与链不匹配，请警告用户并要求更正后再继续。
8. 严格验证参数 -- 调用 API 前，验证每个字段：
   • 必须提供所有必填参数，且参数值合法
   • chain 必须是 sol/eth/bsc/base 之一
   • isBuy 必须是布尔值 true 或 false
   • 买入时的 amount 必须 > 0；卖出时必须为 1-100
   • 必须提供 tip；SOL 链：0.0001-0.1（单位：SOL）；EVM 链：0.1-100（单位：Gwei）。如果 tip 超出建议范围，必须警告用户可能产生较高费用，并要求用户明确确认后再继续
   • 如果提供了 model，则必须为 1 或 2
   • priorityFee（如提供）仅适用于 Solana 链
   • 对于 BSC 启动，除非用户明确要求 OpenFour 或提供受支持的 OpenFour 模板 ID，否则保持 launchMode=legacy
   • 对于 OpenFour 启动，要求 templateId 为 1778027615723、1778027615724、1778027615725、1778027615728 之一；不要将 legacy tokenTaxInfo 与 OpenFour 参数混用
   • 不得发送上述参数表中未列出的字段名
   • 如果任何验证失败，拒绝发送请求，并要求用户更正

资讯流规则

1. 类型验证 —— 仅接受 NEW、ALMOST、COMPLETED（大写）。拒绝任何其他值。
2. 链验证 —— 支持全部 4 条链：sol、eth、bsc、base。默认使用 sol。
3. 单次查询模式（默认） —— 调用 Feed API 一次，为每个代币整理并显示关键信息：symbol、priceUSD、marketCapUSD、holders、devHoldPercent、launchPlatform（名称 + 进度）。
4. 持续监控模式 —— 仅当用户明确说“持续监控”、“monitor”或“watch”时启用：
   • 使用 Bash 轮询循环，每 5 秒调用一次 Feed API
   • 按 tokenAddress 去重 —— 仅显示新出现的代币
   • 循环上限：480 秒（8 分钟）。将 Bash 超时设为 540000ms
   • 循环结束后，使用 AskUserQuestion 询问：继续监控 / 查看代币详情 / 买入代币 / 停止
   • 继续监控时，保留已记录的 tokenAddress 集合，避免重复
5. 筛选指引 —— 查询前，可询问用户的筛选偏好（市值范围、流动性、持币人数等）。如果未询问，则不使用筛选条件（返回全部结果）。
6. 禁止自动交易 —— Feed 扫描仅用于观察。绝不能根据扫描结果自动买入或卖出。
7. 错误处理 —— 请参阅错误代码表。对于数据查询 API：code == 200 且 success == true 表示成功；code == 300 表示服务器错误（告知用户稍后重试）；code == 8060/8061 表示立即停止；code == 8062 表示等待 2 秒后重试。

代币查询规则

1. 必须提供 ca —— 必须提供合约地址（ca）。如果缺少，请向用户索取。
2. 链验证 —— 支持全部 4 条链：sol、eth、bsc、base。默认使用 sol。
3. HoneyPot 警告 —— 如果 securityInfo.honeyPot == true，请醒目警告用户该代币是蜜罐，交易风险极高。
4. 高税率提醒 —— 如果 taxInfo.buy 或 taxInfo.sell > 5%，提醒用户税率较高。
5. 显示格式 —— 按组展示结果：交易信息 → 安全检查 → 税率 → 持币分布 → 社交链接。
6. 交易后续操作 —— 显示查询结果后，可询问用户是否想买入该代币，并链接到买入代币流程。
7. 错误处理 —— 与资讯流规则相同（请参阅错误代码表）。

钱包规则

1. 链验证 —— 支持全部 4 条链。默认使用 sol。
2. 显示格式 —— 显示钱包名称、地址和原生代币余额。用 ⭐ 标记置顶钱包。
3. 代币持仓 —— 如果用户询问特定代币的持仓情况，传入 tokenAddress 以显示每个钱包的余额。
4. 没有钱包 —— 如果响应返回空列表，请引导用户前往 https://www.xxyy.io/wallet/manager?chainId={chain} 创建钱包。
5. 默认钱包记忆 —— 用户选择钱包后，在当前会话中将其记为该链的默认钱包。同一条链后续交易时使用此默认钱包，无需再次询问。
6. 单钱包查询 —— 用户提供特定钱包地址并询问其余额时，使用 Wallet Info API，而非 List Wallets。交易确认前也使用 Wallet Info 显示余额。
7. 错误处理 —— 与其他数据查询 API 相同（请参阅错误代码表）。

自动卖出规则（止盈止损）

管理止盈止损规则。启用自动卖出后，买入代币会根据这些规则自动创建待处理的卖出订单。

列出规则

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/list

无需参数。返回当前用户的所有规则。

响应：

{
  "code": 200,
  "data": [
    {
      "id": 123,
      "taskFlag": 0,
      "pricePercent": 30,
      "sellPercent": 100,
      "isTrailing": 1,
      "createTime": "2026-04-09T08:00:00.000+00:00"
    }
  ],
  "success": true
}

字段：

• taskFlag：0 = 止损，1 = 止盈
• pricePercent：触发百分比（例如，30 = 价格较买入价下跌/上涨 30%）
• sellPercent：要卖出的持仓百分比（0-100）
• isTrailing：1 = 启用追踪止损，0 = 禁用。仅对止损规则（taskFlag=0）有效。启用后，随着代币价格上涨，止损价会自动跟随上移，锁定利润。

创建/更新规则

POST ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/createOrUpdate

⚠️ 这是一次完整替换 —— 所有现有规则都会被删除，并替换为提供的列表。请求中始终包含所有所需规则（包括新规则和现有规则）。

{
  "infos": [
    { "taskFlag": 1, "pricePercent": 100, "sellPercent": 50, "isTrailing": 0 },
    { "taskFlag": 0, "pricePercent": 30, "sellPercent": 100, "isTrailing": 1 }
  ]
}

行为说明：

1. 用户想要添加规则时，先调用 List 获取现有规则，然后合并并一并发送。
2. 止盈规则（taskFlag=1）会忽略 isTrailing，并始终将其存储为 0。

删除规则

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/delete?ids=123,456

• ids（必填）：要删除的规则 ID，以逗号分隔。只会删除当前用户拥有的规则。

切换自动卖出

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/open

参数	必填	默认值	描述
flag	是	—	true 表示启用，false 表示停用自动卖出
tokenAddress	否	""	设置后，只平掉此代币的待处理订单
closeAll	否	false	若为 true，则关闭所有待处理的自动卖出订单

行为说明：

1. 切换为关闭状态不会删除规则，只会停用自动卖出，并可选择关闭待处理订单。
2. closeAll=true 会移除自动卖出规则生成的所有待处理限价订单。
3. 只有在 flag=false 时，tokenAddress 和 closeAll 才适用。

代币持有者列表

查询代币持有者信息，包括大户、关注的钱包、KOL 钱包和内部人士钱包。

GET ${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/holders/{type}

参数	类型	必填	描述
type	路径	是	持有者类型：top（前 20 名持有者）、follow（关注的钱包）、kol（KOL 钱包）、insider（内部人士钱包）
mint	查询参数	否	代币合约地址
pair	查询参数	否	池地址/交易对地址
wallet	查询参数	否	用于筛选的钱包地址
chain	查询参数	否	区块链，默认为 sol。支持 bsc、base 等。

响应字段（每位持有者）：

• address — 钱包地址
• name — 钱包名称（仅关注的钱包有值，否则为 null）
• holdAmount — 持有的代币数量
• holdPercent — 持有比例（例如，“39.16”表示 39.16%）
• holdValueNative — 以原生代币（SOL/BNB）计的持仓价值
• holdValueUSD — 以 USD 计的持仓价值
• tags — 标签：NEW、SNIPER、BUNDLE、INSIDER、LP
• tradeCount / buyCount / sellCount — 交易统计（可为 null）
• profitNative / profitUSD / profitPercent — 利润数据（可为 null）
• avgBuyPrice / avgSellPrice — 平均交易价格（可为 null）
• tokenSourceType — 代币来源：1 = 买入，2 = 转入
• nativeBalance — 钱包的原生代币余额

行为说明：

1. 至少应提供 mint 或 pair 中的一项，才能获得有意义的结果。
2. follow 类型会返回用户关注的钱包列表中的持有者——结果取决于用户的关注配置。
3. 许多字段的响应数据可能为 null——通过转账收到代币的持有者（tokenSourceType=2）通常没有交易/利润数据。

入门流程

触发条件：在会话中首次激活该技能时自动执行一次。每个会话仅运行一次。

检测逻辑

1. 检查环境中是否已设置 $XXYY_API_KEY。
2. 情况 A — 未设置 API Key：显示设置指南：
   • 如何获取密钥：访问 https://www.xxyy.io/apikey
   • 如何设置：export XXYY_API_KEY=xxyy_ak_xxxx
   • 显示功能表（交易、信息流、代币查询、钱包）和可用策略列表。
   • 在用户设置密钥之前，到此为止。
3. 情况 B — 已设置 API Key：静默调用 Ping API。
   • Ping 成功：通过 List Wallets API 静默获取全部 4 条链（sol、eth、bsc、base）的钱包。每条链选择索引为 0 的钱包作为默认钱包；如果没有钱包，则显示“N/A”。显示：
     • 功能表（交易、信息流、代币查询、钱包）
     • 默认钱包表：链 | 钱包名称 | 地址 | 余额
     • 可用策略列表（策略 1/2/3 及其触发语句）
     • 提示：使用 修改默认钱包 {chain} {wallet name or address} 更改默认钱包
   • Ping 失败（8060/8061）：情况 C — 告知用户 API Key 无效或已停用，并引导他们前往 https://www.xxyy.io/apikey 重新生成。

更改默认钱包

当用户说“修改默认钱包 {chain} {wallet name or address}”时：

• 根据该链的 List Wallets 结果，按钱包名称（不区分大小写）或地址进行匹配。
• 如果匹配成功，更新会话默认钱包并确认。
• 如果没有匹配项，显示该链的可用钱包并请用户选择。

非阻塞

如果用户在完成引导前发送了操作命令（例如买入/卖出/扫描），则在后台静默完成检测，并直接处理其命令。

策略规则（通用）

以下规则适用于下面的所有三种策略。

1. 钱包前置条件 — 如果所需链未设置默认钱包，先执行引导中的钱包获取步骤。
2. 确认表 — 每次交易前，显示包含以下内容的确认表：链、操作（买入/卖出）、钱包（名称 + 地址 + 余额）、代币（符号 + 地址）、金额、小费、滑点。只有在用户明确确认后才继续。
3. 结果显示 — 交易完成后，显示：txId、状态、区块浏览器链接（参见区块浏览器 URL）。
4. 互斥规则 — 同一时间只能运行一个轮询策略（策略 2 或 3）。启动新策略时，停止当前策略。
5. 停止命令 — 用户说“stop”或“停止”→ 立即终止正在运行的轮询策略。
6. 不自动交易 — 策略 2 和 3 只扫描并显示结果。绝不自动提交交易。用户必须明确选择买入。
7. 修改金额 — 用户说“修改金额 {value}”→ 更新下一笔交易的买入金额（不影响正在进行的交易）。
8. 默认参数 — SOL：滑点 20%，小费 0.0001 SOL。EVM 链（eth/bsc/base）：滑点 20%，小费 1 Gwei。用户可以覆盖这些参数。
9. 错误处理 — 8060/8061：立即停止策略。8062：等待 2s 后重试。300：告知用户服务器错误。
10. 参数验证 — 所有交易均遵循执行规则 #8（严格参数验证）。

策略 1：直接买入/卖出

触发条件：用户提供代币合约地址并表达买入/卖出意图（例如“买 0x... 0.1 BNB”、“卖出 ... 的 50%”）。

流程

1. 解析意图：识别操作（买入/卖出）、代币地址、链、金额和钱包。
2. 自动检测链：0x 前缀 → EVM 链。如果无法确定具体的 EVM 链（eth/bsc/base），则询问用户。Base58 格式 → SOL。
3. 选择钱包：遵循执行规则 #2（自动查询钱包逻辑）。
4. 显示确认表（参见策略规则 #2）。
5. 用户确认 → 调用 Swap API → 轮询交易状态（执行规则 #4）→ 显示结果（策略规则 #3）。
6. 失败时：不要重试。向用户显示错误（执行规则 #6）。

策略 2：AI 自动扫描

触发条件：用户说“AI 扫链”、“AI scan”、“auto scan”、“smart scan”或“开始 AI 扫链”。

设置

1. 确认 SOL 和 BSC 的默认钱包已存在（Feed 所需链）。如果缺少，通过 Onboarding 获取。
2. 确认每条链的买入金额。默认值：0.1 SOL / 0.001 BNB。用户可以自定义。
3. 显示配置摘要：钱包、金额、扫描层级。

扫描层级

每轮轮询时，三个层级并行运行。这些是经过预验证的筛选参数，用户可以修改。

层级 A — NEW（新上线的代币）：

{"topHp":"22,40","snipers":",6","insiderHp":",8","holder":"10,","mc":"8000,","oneLink":1,"createTime":"1,70"}

Feed 类型：NEW

层级 B — ALMOST（即将毕业的代币）：

{"createTime":"1,120","dexPay":1,"mc":"13000,"}

Feed 类型：ALMOST

层级 C — COMPLETED（已毕业的代币）：

{"createTime":"1,240","topHp":"18,","holder":"300,","mc":"20000,160000"}

Feed 类型：COMPLETED

轮询逻辑

• 间隔：每轮间隔 5 分钟。
• 每轮请求数：3 个层级 × 2 条链（sol + bsc）= 最多 6 次 Feed API 调用。
• 最长时长：60 分钟。60 分钟后，询问用户是否继续。
• 去重：在所有轮次和链之间跟踪 tokenAddress。只显示新发现的代币。

显示格式

对于发现的每个新代币，显示：

字段	来源
代币符号	symbol
链	请求链
价格	priceUSD
市值	marketCapUSD
持有者	holders
开发者持有比例	devHoldPercent
平台 + 进度	launchPlatform.name + launchPlatform.progress
匹配层级	A / B / C

用户交互

显示新代币后，用户可以：

• 选择代币 → 调用 Token Query API，显示完整详情（安全性、税费、链接、持有者）。
• 买入代币 → 切换到策略 1 流程，并使用所选代币。
• 跳过 / 继续 → 等待下一轮轮询。

策略 3：推文扫描

触发条件：用户说“推文扫链”、“tweet scan”、“twitter scan”或“开始推文扫链”。

默认监控账号

@heyibinance、@cz_binance — 推荐默认账号。用户可以在扫描前或扫描期间修改。

设置

1. 确认监控的 Twitter 账号列表。
2. 确认 BSC 钱包已存在（推文扫描仅支持 BSC）。如果缺少，通过 Onboarding 获取。
3. 确认买入金额。默认值：0.001 BNB。
4. 显示配置摘要：账号、钱包、金额。
5. 固定参数（用户不可修改）：tip = 5 Gwei，slippage = 50%，model = 1。

轮询流程

每 5 秒：

1. 调用 POST /feed/NEW?chain=bsc，请求体为 {"oneLink":1}，获取带有社交链接的 BSC 新代币。
2. 使用 seen_token_addresses 集合，根据 tokenAddress 去重。
3. 对于每个 hasLink == true 的新代币： a. 调用 GET /query?ca={tokenAddress}&chain=bsc，获取包含 linkInfo 的完整代币详情。 b. 检查 linkInfo.x 是否包含任何受监控账号句柄（不区分大小写的子字符串匹配）。 c. 同时使用 seen_twitter_urls 集合，根据 linkInfo.x URL 去重。
4. 匹配成功 → 显示代币详情和确认表格。等待用户响应（买入 / 跳过）。
5. 无匹配项 → 静默跳过，继续轮询。

时长

• 最长时长：30 分钟。30 分钟后，询问用户是否继续。
• 使用 Bash 轮询循环。将 Bash 超时设为 1860000ms（31 分钟）。

账号管理

• “修改账号 @xxx” → 将整个监控列表替换为新账号。下一轮轮询生效。
• “添加账号 @xxx” → 将新账号添加到监控列表。下一轮轮询生效。

状态行

扫描期间显示状态行：

[HH:MM:SS] Scanning BSC... (watching: @heyibinance, @cz_binance) #N

其中 #N 表示目前已扫描的代币数量。

钱包地址格式

链	格式	示例模式
SOL	Base58，32-44 个字符	7xKX...
ETH / BSC / Base	0x + 40 个十六进制字符	0x1a2B...

区块浏览器 URL

• SOL：https://solscan.io/tx/{txId}
• ETH：https://etherscan.io/tx/{txId}
• BSC：https://bscscan.com/tx/{txId}
• BASE：https://basescan.org/tx/{txId}

错误代码

代码	含义	适用范围
200	成功	数据查询 API（Feed、Token Query）
300	服务器错误 — 告知用户稍后重试	数据查询 API（Feed、Token Query）
8060	API Key 无效	所有 API
8061	API Key 已禁用	所有 API
8062	请求频率受限	所有 API — 数据查询：2s 后重试；交易：1s 后重试（swap 除外，参见执行规则 #5）
8063	IP 不在白名单中 — 使用 get_ip 检查当前 IP，并在 https://www.xxyy.io/apikey 更新白名单	所有 API

curl 示例

# Buy
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/swap" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"sol","walletAddress":"...","tokenAddress":"...","isBuy":true,"amount":0.1,"tip":0.0001}'

# Query Trade
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/trade?txId=..." \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Feed - Scan newly launched tokens on SOL (with filters)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/feed/NEW?chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mc":"10000,500000","holder":"50,","insiderHp":",50"}'

# Token Query
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/query?ca=TOKEN_ADDRESS&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# List Wallets
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/wallets?chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Wallet Info
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/wallet/info?walletAddress=YOUR_WALLET&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# PNL Query
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/pnl?walletAddress=YOUR_WALLET&tokenAddress=TOKEN_ADDRESS&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Trade History
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/trades?walletAddress=YOUR_WALLET&chain=sol&pageNum=1&pageSize=10" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Get IP (exempt from IP whitelist)
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/ip" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# KOL Buy List
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/kol-buy-list?chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Tag Holder Buy List
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/tag-holder-buy-list?chain=bsc" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Label List (SOL only)
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/label-list?chain=sol&labelType=AGENT_KOL" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Signal List (SOL/BSC)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/signal-list?type=open-ai-trending&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Trending List (SOL/BSC)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/trending-list?chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period": "5M"}'

# Launch Token - SOL (create only)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/sol/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<SOL_WALLET>","name":"My Token","symbol":"MTK","buyAmount":"0","solOptions":{"uri":"https://arweave.net/<metadata_id>","slippage":10000,"priorityFee":100000,"tipFee":100000,"model":1}}'

# Launch Token - SOL (create + buy 0.5 SOL)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/sol/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<SOL_WALLET>","name":"My Token","symbol":"MTK","buyAmount":"0.5","solOptions":{"uri":"https://arweave.net/<metadata_id>","slippage":10000,"priorityFee":100000,"tipFee":100000,"model":1,"cashback":true}}'

# Launch Token - BSC (create + buy 0.001 BNB)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/bsc/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<BSC_WALLET>","name":"Exchange the world","symbol":"ETW","buyAmount":"0.001","bscOptions":{"desc":"Exchange the world","image":"https://example.com/image.png","label":"Meme","gasPrice":"3000000000","model":1,"feePlan":false}}'

# Launch Token - BSC (with legacy token tax)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/bsc/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<BSC_WALLET>","name":"Tax Token","symbol":"TAXT","buyAmount":"0.1","bscOptions":{"desc":"A token with tax","image":"https://example.com/image.png","label":"Defi","model":1,"tokenTaxInfo":{"feeRate":5,"burnRate":20,"divideRate":30,"liquidityRate":0,"recipientRate":50,"minSharing":100000,"recipientAddress":"0x..."}}}'

# Launch Token - BSC OpenFour Cubepeg (create + buy 0.001 BNB; hookSalt auto-mined)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/bsc/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<BSC_WALLET>","name":"Cube Token","symbol":"CUBE","buyAmount":"0.001","bscOptions":{"desc":"OpenFour Cubepeg token","image":"https://example.com/image.png","label":"Meme","model":1,"launchMode":"openfour","templateId":"1778027615728"}}'

# Launch Token - BSC OpenFour Likwid Dex
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/bsc/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<BSC_WALLET>","name":"Likwid Token","symbol":"LIQ","buyAmount":"0","bscOptions":{"desc":"OpenFour Likwid Dex token","image":"https://example.com/image.png","label":"Meme","model":1,"launchMode":"openfour","templateId":"1778027615725"}}'

# Launch Token - BSC OpenFour Creator Incentives
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/bsc/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<BSC_WALLET>","name":"Creator Token","symbol":"CRT","buyAmount":"0.001","bscOptions":{"desc":"OpenFour Creator Incentives token","image":"https://example.com/image.png","label":"Meme","model":1,"launchMode":"openfour","templateId":"1778027615724"}}'

# Launch Token - BSC OpenFour SkillRoyalty (1% buy/sell fee)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/bsc/launch" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"<BSC_WALLET>","name":"Royalty Token","symbol":"ROY","buyAmount":"0.001","bscOptions":{"desc":"OpenFour SkillRoyalty token","image":"https://example.com/image.png","label":"Meme","model":1,"launchMode":"openfour","templateId":"1778027615723","openFourParams":{"buyFeeRate":100,"sellFeeRate":100,"rateFounder":100,"rateHolder":0,"rateBurn":0,"rateLiquidity":0,"minShare":"1"}}}'

# Auto-Sell: List rules
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/list" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Auto-Sell: Create rules (full replacement - include ALL desired rules)
curl -s -X POST "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/createOrUpdate" \
  -H "Authorization: Bearer $XXYY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"infos":[{"taskFlag":1,"pricePercent":100,"sellPercent":50,"isTrailing":0},{"taskFlag":0,"pricePercent":30,"sellPercent":100,"isTrailing":1}]}'

# Auto-Sell: Delete rules by ID
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/delete?ids=123,456" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Auto-Sell: Enable
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/open?flag=true" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Auto-Sell: Disable and close all pending orders
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/autoSell/open?flag=false&closeAll=true" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Holders: Top holders (SOL)
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/holders/top?mint=<TOKEN_ADDRESS>&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Holders: KOL holders (BSC, with pair)
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/holders/kol?mint=<TOKEN_ADDRESS>&pair=<PAIR_ADDRESS>&chain=bsc" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Holders: Followed wallets
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/holders/follow?mint=<TOKEN_ADDRESS>&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"

# Holders: Insider wallets
curl -s "${XXYY_API_BASE_URL:-https://www.xxyy.io}/api/trade/open/api/holders/insider?mint=<TOKEN_ADDRESS>&chain=sol" \
  -H "Authorization: Bearer $XXYY_API_KEY"