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 はありません。同じキーがデータ照会と取引の両方に署名します。XXYY_API_KEY はホットウォレットの秘密鍵と同様に扱ってください。このスキルでは、各セッションで最初の取引時に一度だけリスク確認が表示されます。その後は取引内容のみが確認され、すばやく取引できます。

• ⚠️ API Key = ウォレットへのアクセス -- XXYY API Key を使うと、ウォレット残高で実際のオンチェーン取引を実行できます。キーが漏えいすると、誰でもあなたの資金でトークンを売買できてしまいます。共有したり、バージョン管理にコミットしたり、ログや公開チャンネルに露出させたりしないでください。漏えいの疑いがある場合は、https://xxyy.io ですぐにキーを再生成してください。
• カストディアル取引モデル -- XXYY はカストディアル取引プラットフォームです。提供するのはウォレットアドレス（公開鍵）と API Key のみです。秘密鍵やウォレットによる署名は不要です。XXYY がプラットフォームを通じて、あなたに代わって取引を実行します。
• 読み取り専用モードなし -- データ照会（Feed、Token Query）と取引（Buy、Sell）の両方で同じ API Key を使用します。現在、読み取り専用の別キーはありません。
• IP ホワイトリスト（推奨） -- セキュリティを強化するには、https://www.xxyy.io/apikey で API Key の IP ホワイトリストを設定してください。ホワイトリストに登録された IP のみが API を呼び出せます。ホワイトリストを設定する前に、get_ip ツールを使って現在の送信元 IP を確認してください。

API リファレンス

厳守：存在するのは以下に記載されたエンドポイントのみです。ここに明記されていない URL を推測、推論、または組み立ててはいけません。以下に記載されていない機能が必要な場合は、ユーザーに対応していないことを伝えてください。

エンドポイントの全一覧：

• POST /api/trade/open/api/swap — Buy / Sell
• 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 — Token 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
}

購入パラメーター

Param	必須	型	有効な値	説明
chain	YES	string	sol / eth / bsc / base	この4つの値のみ受け付けます
walletAddress	YES	string	SOL: Base58 32-44文字；EVM: 0x+40hex	XXYY プラットフォーム上のウォレットアドレスです。チェーンと一致する必要があります
tokenAddress	YES	string	有効なコントラクトアドレス	購入するトークンのコントラクトアドレス
isBuy	YES	boolean	true	購入の場合はtrueである必要があります
amount	YES	number	> 0	ネイティブ通貨（SOL/ETH/BNB）での金額
tip	YES	number	SOL: 0.0001-0.1（単位：SOL）；EVM: 0.1-100（単位：Gwei）	すべてのチェーンに適用される優先手数料です。指定しない場合はpriorityFeeにフォールバックします
slippage	NO	number	0-100	スリッページ許容率（％）、デフォルトは20
model	NO	number	1 or 2	1=サンドイッチ攻撃対策（デフォルト）、2=高速モード
priorityFee	NO	number	>= 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
}

売却パラメーター

Param	必須	型	有効な値	説明
chain	YES	string	sol / eth / bsc / base	この4つの値のみ受け付けます
walletAddress	YES	string	SOL: Base58 32-44文字；EVM: 0x+40hex	XXYY プラットフォーム上のウォレットアドレスです。チェーンと一致する必要があります
tokenAddress	YES	string	有効なコントラクトアドレス	売却するトークンのコントラクトアドレス
isBuy	YES	boolean	false	売却の場合はfalseである必要があります
amount	YES	number	1-100	売却率です。例：50 = 保有量の50%を売却
tip	YES	number	SOL: 0.0001-0.1（単位：SOL）；EVM: 0.1-100（単位：Gwei）	すべてのチェーンに適用される優先手数料です。指定しない場合はpriorityFeeにフォールバックします
slippage	NO	number	0-100	スリッページ許容率（％）、デフォルトは20
model	NO	number	1 or 2	1=サンドイッチ攻撃対策（デフォルト）、2=高速モード
priorityFee	NO	number	>= 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>

特定のウォレットの成功した取引記録をページ分けして照会します。完了したトランザクションのみを返し、作成日時の新しい順に並べます。

取引履歴パラメーター

Param	必須	型	有効な値	説明
walletAddress	YES	string	ウォレットアドレス	現在のAPI Keyユーザーに属している必要があります
chain	YES	string	sol / eth / bsc / base	チェーン識別子（必須）
tokenAddress	NO	string	コントラクトアドレス	特定のトークンで絞り込みます
pageNum	NO	int	>= 1	ページ番号、デフォルトは1
pageSize	NO	int	1-20	1ページあたりの項目数、デフォルトは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キーが有効な場合、「pong」を返します。

フィード（トークンのスキャン）

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

ミームトークンの一覧を取得します。新規ローンチ済み、卒業間近、または卒業済みのトークンが対象です。

パスおよびクエリパラメーター

パラメーター	必須	型	有効な値	説明
type	はい	パス文字列	NEW / ALMOST / COMPLETED	NEW = 新規ローンチ済み、ALMOST = 卒業間近、COMPLETED = 卒業済み
chain	いいえ	クエリ文字列	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 = 有効	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

フィードのレスポンス

{
  "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（name/progress/completed）、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	はい	string	コントラクトアドレス	トークンのコントラクトアドレス
chain	いいえ	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	1ページあたりの項目数。デフォルトは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 キーの許可リストに追加する 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	いいえ	string	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：トークンロゴの URL
• priceNative：ネイティブ通貨での価格
• priceUsd：米ドルでの価格
• marketCap：米ドルでの時価総額
• 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}

タグ付き保有者（スマートマネー、クジラなど）の最近の買いリストを取得します。タグ付きウォレットが最近購入したトークンを表示します。

タグ付き保有者の買いリストのパラメーター

パラメーター	必須	型	有効な値	説明
chain	いいえ	string	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：トークンロゴの URL
• priceNative：ネイティブ通貨での価格
• priceUsd：米ドルでの価格
• marketCap：米ドルでの時価総額
• 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	いいえ	string	sol / eth / bsc / base	デフォルトは sol です。4 つすべてのチェーンに対応しています
labelType	いいえ	string	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：トークンロゴの URL
• priceUSD：米ドルでの現在価格
• marketCapUSD：米ドルでの時価総額
• 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	NO	string	open-ai-trending	デフォルトは open-ai-trending です。現在サポートされているのは open-ai-trending のみです
chain	NO	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	NO	string	sol / bsc	デフォルトは sol です。SOL と BSC のみサポートしています
period	YES	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：トークンのロゴ URL
• createTime：取引ペアの作成タイムスタンプ（ミリ秒）
• symbol：トークンシンボル
• name：トークン名
• tokenAddress：トークンコントラクトアドレス
• pairAddress：取引ペアのアドレス
• priceUSD：現在の USD 建て価格
• priceChange24H：24 時間の価格変動率
• marketCapUSD：USD 建て時価総額
• volume：取引量
• liquid：流動性
• buyCount：買い取引件数
• sellCount：売り取引件数
• holders：保有者数
• devHoldPercent：開発者の保有率
• dexName：DEX プール名
• launchFrom：ローンチプラットフォーム識別子
• launchPlatform：ローンチプラットフォームの詳細（name、progress、completed、launchedPair）
• links：ソーシャルメディアリンク（tg、x、web）
• security：セキュリティ情報 — mintAuthority、freezeAuthority（value=bool、passed=bool）、topHolder、lpBurned（value=number、passed=bool）
• smartWallets：スマートウォレットのアクティビティ（合計件数と、wallet/action/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	YES	string	sol / eth / bsc / base	上記の注を参照してください

ローンチリクエスト本文

パラメーター	必須	型	説明
walletAddress	YES	string	ウォレットアドレス（API キーのアカウントに属している必要があります）
name	YES	string	トークン名
symbol	YES	string	トークンシンボル
buyAmount	NO	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	必須	型	デフォルト	説明
uri	はい	string	-	メタデータ JSON URI（name／symbol／description／image を含む Metaplex 標準）
slippage	いいえ	integer	100	スリッページ（ベーシスポイント）。100 = 1%。buyAmount > 0 の場合にのみ有効です
priorityFee	いいえ	long	100000	優先手数料（lamport）
tipFee	いいえ	long	100000	チップ手数料（lamport）
model	いいえ	integer	1	1 = MEV 保護、2 = 高速モード
creator	いいえ	string	null	作成者のアドレス（base58）。デフォルトは署名ウォレットです
mayhemMode	いいえ	boolean	false	Pump の mayhem モード
cashback	いいえ	boolean	false	Pump のキャッシュバック

buyAmount > 0 の場合、プラットフォーム手数料（1%）が自動的に課金されます。設定は変更できません。

bscOptions (chain=bsc)

Param	必須	型	デフォルト	説明
desc	はい	string	-	トークンの説明
image	はい	string	-	画像 URL／base64／data URI（≤5MB）
label	いいえ	string	"Meme"	カテゴリ：Meme、AI、Defi、Games、Infra、De-Sci、Social、Depin、Charity、Others
gasPrice	いいえ	string	null	カスタムガス価格（wei）。指定がない場合は自動取得されます
model	いいえ	integer	1	1 = MEV 保護（バンドル）、2 = 高速モード
feePlan	いいえ	boolean	false	手数料プランの切り替え
webUrl	いいえ	string	""	ウェブサイト URL
twitterUrl	いいえ	string	""	Twitter URL
telegramUrl	いいえ	string	""	Telegram URL
launchMode	いいえ	string	legacy	既存の FourMeme ローンチには legacy、OpenFour テンプレートには openfour を指定します
templateId	OpenFour	string	-	OpenFour テンプレート ID。launchMode=openfour の場合に必須です
openFourParams	いいえ	object	null	スキーマに準拠した OpenFour パラメーター。可能な場合、サービスが安全なデフォルト値を設定します
initParams	いいえ	object	null	上級者向け：事前エンコード済みの OpenFour モジュールパラメーター。スキーマのバイト列を把握していない場合は使用しないでください
antiSniperEnabled	いいえ	boolean	null	OpenFour の任意のアンチスナイパー切り替え
tokenTaxInfo	いいえ	object	null	レガシー BSC トークン税の設定（下記参照）。OpenFour と併用しないでください

tokenTaxInfo (BSC legacy only)

Param	必須	型	説明
feeRate	はい	integer	取引手数料率。固定値：1、3、5、10（1%～10%を表します）
burnRate	はい	integer	バーン率（0～100）
divideRate	はい	integer	配当分配率（0～100）
liquidityRate	はい	integer	流動性プール率（0～100）
recipientRate	はい	integer	受取人への配分率（0～100）
minSharing	条件付き	long	配当参加に必要な最小トークン量（ether 単位）。divideRate > 0 の場合に必須です。形式：d × 10^n（n≥5、1≤d≤9）
recipientAddress	条件付き	string	受取人のアドレス（0x...）。recipientRate > 0 の場合に必須です

制約： burnRate + divideRate + liquidityRate + recipientRate の合計は 100 である必要があります。

BSC OpenFour テンプレート

Template ID	名前	MCP エイリアス	備考
1778027615723	Goplus SkillRoyalty	skillroyalty	税／ロイヤリティのテンプレートです。手数料率はベーシスポイント単位です。100 = 1%
1778027615724	Goplus Creator Incentives	creator_incentives	通常はサービスのデフォルト値で動作します
1778027615725	Likwid Dex	likwid_dex	通常はサービスのデフォルト値で動作します
1778027615728	Cubepeg	cubepeg	ノードサービスが hookSalt を自動でマイニングするため、通常、呼び出し元が渡す必要はありません

openFourParams（BSC OpenFour）

パラメーター	テンプレート	型	説明
buyFeeRate	SkillRoyalty	integer	購入手数料（bps）。100 = 1%
sellFeeRate	SkillRoyalty	integer	売却手数料（bps）。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が有効なsaltを自動マイニングするため、空のままにしてください

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の手数料率はパーセントではなくbpsです。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	NO	enum	bscOptions.launchMode	legacy または openfour です。省略できます。対応するテンプレートが指定されている場合、OpenFour と推測されます
bsc_openfourTemplate	NO	enum	bscOptions.templateId	エイリアス：skillroyalty、creator_incentives、likwid_dex、cubepeg
bsc_openfourTemplateId	OpenFour	string	bscOptions.templateId	1778027615723、1778027615724、1778027615725、1778027615728 のいずれかです
bsc_openfour_antiSniperEnabled	NO	boolean	bscOptions.antiSniperEnabled	オプションのアンチスナイパー切り替え
bsc_openfour_renderer	Cubepeg only	string	openFourParams.renderer	オプションのレンダラー EVM アドレス
bsc_openfour_hookSalt	NO	bytes32	openFourParams.hookSalt	高度な Cubepeg ソルトです。Node サービスによる自動マイニングを利用する場合は省略してください
bsc_openfour_buyFeeRate	SkillRoyalty only	integer	openFourParams.buyFeeRate	購入手数料（bps）です。100 = 1%
bsc_openfour_sellFeeRate	SkillRoyalty only	integer	openFourParams.sellFeeRate	売却手数料（bps）です。100 = 1%
bsc_openfour_rateFounder	SkillRoyalty only	integer	openFourParams.rateFounder	創設者の配分（0-100）
bsc_openfour_rateHolder	SkillRoyalty only	integer	openFourParams.rateHolder	保有者の配分（0-100）
bsc_openfour_rateBurn	SkillRoyalty only	integer	openFourParams.rateBurn	バーンの配分（0-100）
bsc_openfour_rateLiquidity	SkillRoyalty only	integer	openFourParams.rateLiquidity	流動性の配分（0-100）
bsc_openfour_minShare	SkillRoyalty only	string	openFourParams.minShare	最小配分しきい値です。文字列として渡してください
bsc_openfour_founder	SkillRoyalty only	string	openFourParams.founder	創設者の EVM アドレスです。Node サービスでは署名ウォレットがデフォルトになります
bsc_openfourParamsJson	NO	JSON object string	bscOptions.openFourParams	高度な生パラメーターです。型付きの bsc_openfour_* フィールドより前にマージされます
bsc_openfourInitParamsJson	NO	JSON object string	bscOptions.initParams	高度なエンコード済みモジュールパラメーターです。スキーマのバイト列が分かっている場合を除き、使用しないでください

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 キーが無効です
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 は約25秒、BSC は約3～5秒
• SOL の uri には、アクセス可能な JSON メタデータ URL（Metaplex Token Metadata 標準）を指定する必要があります
• BSC の画像アップロードは FourMeme プラットフォーム内部で処理されます
• BSC のレガシーモードは既存の FourMeme 起動フロー用です。BSC OpenFour モードは、サポート対象の4つの OpenFour テンプレート専用です
• bsc_openfourTemplate または bsc_openfourTemplateId が指定されている場合、MCP の bsc_launchMode は省略できます。それ以外の場合、BSC の起動はレガシーモードのままです
• OpenFour ではレガシーの tokenTaxInfo は使用しません。代わりに openFourParams / MCP bsc_openfour_* を使用してください
• SOL のミントアドレスはサーバーによってランダムに生成されます
• SOL のプラットフォーム手数料（1%）は、buyAmount > 0 の場合に自動的に徴収されます

実行ルール

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. 取引結果をポーリングする — スワップ送信後、5秒間隔で最大3回、取引ステータスを照会します
5. トランザクションリンクを表示する — txId を含むブロックエクスプローラーの URL を必ず表示します
6. 失敗したスワップリクエストを再試行しない — 代わりにエラーをユーザーに表示します
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 のいずれかである必要があります。レガシーの tokenTaxInfo と OpenFour のパラメーターを混在させないでください
   • 上記のパラメーターテーブルにないフィールド名は送信しないでください
   • 検証に失敗した場合はリクエストを送信せず、ユーザーに修正を求めてください

フィードのルール

1. タイプの検証 -- NEW、ALMOST、COMPLETED（大文字）のみ受け付けます。それ以外の値は拒否します。
2. チェーンの検証 -- 4 つのチェーンすべてに対応しています：sol、eth、bsc、base。デフォルトは sol です。
3. 単一クエリモード（デフォルト） -- Feed API を 1 回呼び出し、各トークンの主要情報（symbol、priceUSD、marketCapUSD、holders、devHoldPercent、launchPlatform（名前＋進捗状況））を整形して表示します。
4. 継続監視モード -- ユーザーが「持续监控」、「monitor」、「watch」のいずれかを明示した場合にのみ有効にします：
   • Bash のポーリングループを使用し、5 秒ごとに Feed API を呼び出します
   • tokenAddress で重複を排除し、新たに表示されたトークンのみを表示します
   • ループの制限時間は 480 秒（8 分）です。Bash のタイムアウトを 540000ms に設定します
   • ループ終了後、AskUserQuestion を使用して、監視の継続／トークン詳細の表示／トークンの購入／停止について尋ねます
   • 継続する場合、重複を避けるため、既出の tokenAddress のセットを保持します
5. フィルターに関する案内 -- クエリの前に、フィルター設定（時価総額の範囲、流動性、保有者数など）を任意でユーザーに尋ねます。尋ねない場合はフィルターを使わず、すべてを返します。
6. 自動取引なし -- フィードのスキャンは情報確認のみを目的とします。スキャン結果に基づいて自動的に購入または売却してはなりません。
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. ハニーポット警告 -- 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. 単一ウォレットのクエリ -- ユーザーが特定のウォレットアドレスを提示して残高を尋ねた場合、List Wallets ではなく Wallet Info API を使用します。取引確認の前に残高を表示する場合も 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

Param	Required	Default	Description
flag	はい	—	true で有効化、false で自動売却を無効化します
tokenAddress	いいえ	""	指定すると、このトークンの保留中注文のみをクローズします
closeAll	いいえ	false	true の場合、自動売却の保留中注文をすべてクローズします

動作に関する注意：

1. 無効にしてもルールは削除されません。自動売却が無効になり、必要に応じて保留中の注文がクローズされるだけです。
2. closeAll=true にすると、自動売却ルールによって生成された保留中の指値注文がすべて削除されます。
3. tokenAddress と closeAll は、flag=false の場合にのみ関係します。

トークン保有者リスト

上位保有者、フォロー中のウォレット、KOL ウォレット、インサイダーウォレットなど、トークン保有者の情報を照会します。

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

Param	Type	Required	Description
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）では、通常、取引／利益データが null になります。

オンボーディングフロー

トリガー：このスキルがセッション内で初めて有効化されたときに、自動的に一度だけ実行します。セッションごとに一度だけ実行してください。

検出ロジック

1. 環境変数に $XXYY_API_KEY が設定されているか確認します。
2. ケース A — API キーなし：セットアップガイドを表示します。
   • キーの取得方法：https://www.xxyy.io/apikey にアクセスします
   • 設定方法：export XXYY_API_KEY=xxyy_ak_xxxx
   • 機能一覧（Trade、Feed、Token Query、Wallets）と利用可能なストラテジーの一覧を表示します。
   • ユーザーがキーを設定するまで、ここで停止します。
3. ケース B — API キーあり：Ping API をサイレントに呼び出します。
   • Ping 成功：List Wallets API を使用して、4 つのチェーン（sol、eth、bsc、base）すべてのウォレットをサイレントに取得します。各チェーンでインデックス 0 のウォレットをデフォルトとして選択します。ウォレットがない場合は「N/A」と表示します。以下を表示します。
     • 機能一覧（Trade、Feed、Token Query、Wallets）
     • デフォルトウォレット一覧：Chain | Wallet Name | Address | Balance
     • 利用可能なストラテジーの一覧（トリガーフレーズ付きの Strategy 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 の結果と照合し、ウォレット名（大文字と小文字を区別しない）またはアドレスで一致するものを探します。
• 一致した場合は、セッションのデフォルトを更新して確認します。
• 一致するものがない場合は、そのチェーンで利用可能なウォレットを表示し、選択するようユーザーに求めます。

ノンブロッキング動作

オンボーディングが完了する前にユーザーがアクションコマンド（例：買い／売り／スキャン）を送信した場合は、検出をバックグラウンドでサイレントに完了してから、ユーザーのコマンドを直接処理します。

ストラテジー共通ルール

以下のルールは、後述する 3 つすべてのストラテジーに適用されます。

1. ウォレットの前提条件 — 必要なチェーンにデフォルトウォレットが設定されていない場合は、まずオンボーディングのウォレット取得手順を実行します。
2. 確認テーブル — 取引の前に毎回、チェーン、アクション（買い／売り）、ウォレット（名前＋アドレス＋残高）、トークン（シンボル＋アドレス）、数量、チップ、スリッページを含む確認テーブルを表示します。ユーザーが明示的に確認した後にのみ続行します。
3. 結果の表示 — 取引完了後、txId、ステータス、ブロックエクスプローラーのリンク（ブロックエクスプローラー URL を参照）を表示します。
4. 相互排他 — 同時に実行できるポーリングストラテジー（Strategy 2 または 3）は 1 つだけです。新しいストラテジーを開始すると、現在のものを停止します。
5. 停止コマンド — ユーザーが「stop」または「停止」と言った場合、実行中のポーリングストラテジーを直ちに終了します。
6. 自動取引禁止 — Strategy 2 と 3 のスキャンでは結果の表示のみを行います。取引を自動的に送信してはなりません。ユーザーが明示的に買いを選択する必要があります。
7. 数量の変更 — ユーザーが「修改金额 {value}」と言った場合、次の取引の買い数量を更新します（実行中の取引には影響しません）。
8. デフォルトパラメーター — SOL：スリッページ 20%、チップ 0.0001 SOL。EVM チェーン（eth/bsc/base）：スリッページ 20%、チップ 1 Gwei。ユーザーは上書きできます。
9. エラー処理 — 8060/8061：ストラテジーを直ちに停止します。8062：2 秒待って再試行します。300：サーバーエラーをユーザーに通知します。
10. パラメーターの検証 — すべての取引で、実行ルール #8 の厳密なパラメーター検証に従います。

Strategy 1：直接買い／売り

トリガー：ユーザーが売買の意図とともにトークンコントラクトアドレスを指定します（例：「买 0x... 0.1 BNB」、「sell 50% of ...」）。

フロー

1. 意図の解析：アクション（買い／売り）、トークンアドレス、チェーン、数量、ウォレットを特定します。
2. チェーンの自動検出：0x プレフィックスの場合は EVM チェーンです。特定の EVM チェーン（eth/bsc/base）を判定できない場合は、ユーザーに確認します。Base58 形式の場合は SOL です。
3. ウォレットの選択：実行ルール #2（ウォレットの自動照会ロジック）に従います。
4. 確認テーブルを表示（ストラテジー共通ルール #2 を参照）。
5. ユーザーが確認 → Swap API を呼び出す → 取引ステータスをポーリングする（実行ルール #4） → 結果を表示する（ストラテジー共通ルール #3）。
6. 失敗時：再試行してはなりません。エラーをユーザーに表示します（実行ルール #6）。

Strategy 2：AI 自動スキャン

トリガー：ユーザーが「AI扫链」、「AI scan」、「auto scan」、「smart scan」、または「开始AI扫链」と言った場合。

セットアップ

1. SOL と BSC のデフォルトウォレットが存在することを確認します（Feed で必要なチェーンです）。存在しない場合は、Onboarding から取得します。
2. チェーンごとの購入金額を確認します。デフォルトは 0.1 SOL / 0.001 BNB です。ユーザーはカスタマイズできます。
3. 設定の概要（ウォレット、金額、スキャンティア）を表示します。

スキャンティア

各ポーリングラウンドで、3 つのティアを並行して実行します。これらは事前検証済みのフィルターパラメーターであり、ユーザーは変更できます。

Tier A — NEW（新しくローンチされたトークン）：

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

Feed タイプ：NEW

Tier B — ALMOST（卒業間近のトークン）：

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

Feed タイプ：ALMOST

Tier 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 を呼び出して、詳細情報（セキュリティ、税金、リンク、保有者）を表示します。
• トークンを購入 → 選択したトークンを使って Strategy 1 のフローに切り替えます。
• スキップ / 続行 → 次のポーリングラウンドまで待機します。

Strategy 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 桁の 16 進数	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 — データクエリ：2秒後に再試行、取引：1秒後に再試行（swap を除く。Execution Rules #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"