XXYY Trade

Solana、Ethereum、BSC および Base における オンチェーン トークン取引およびデータクエリを XXYY Open API 経由で実行します。

前提条件

使用前に環境変数を設定してください：

• XXYY_API_KEY (必須) -- XXYY Open API キー (xxyy_ak_xxxx 形式)。https://www.xxyy.io/apikey から取得できます
• XXYY_API_BASE_URL (オプション) -- API ベース URL、デフォルトは https://www.xxyy.io

認証

すべてのリクエストにはヘッダーが必要です：Authorization: Bearer $XXYY_API_KEY

セキュリティに関する注意

⚠ 初回使用前に読んでください。 このスキルは 実際のオンチェーン取引 を実資金で実行します。リードオンリー API キーは存在しません — 同じキーでデータクエリと取引の両方に署名します。XXYY_API_KEY をホット ウォレット秘密鍵のように扱ってください。このスキルは初回取引時にセッションごとに 1 回限定のリスク確認を表示します。その後は取引の詳細のみ確認されるため、取引が高速に保たれます。

• ⚠️ API キー = ウォレットアクセス -- XXYY API キーは実際のオンチェーン取引を実行でき、ウォレット残高を使用してトークンを買売できます。流出した場合、誰でもあなたの資金でトークンを買売できます。絶対に共有しないでください。バージョン管理にコミットしないでください。ログやパブリック チャネルで公開しないでください。流出の疑いがある場合は、すぐに https://xxyy.io でキーを再生成してください。
• カストディアル取引モデル -- XXYY はカストディアル取引プラットフォームです。ウォレット アドレス (公開キー) と API キーのみを提供します。秘密鍵やウォレット署名は不要です -- XXYY がプラットフォームを通じてあなたに代わって取引を実行します。
• リードオンリー モードなし -- 同じ API キーがデータ クエリ (フィード、トークン クエリ) と取引 (買い、売り) の両方に使用されます。現在、リードオンリー キーを別に提供していません。
• IP ホワイトリスト (推奨) -- さらにセキュリティを強化するために、https://www.xxyy.io/apikey で API キーの 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} — フィード スキャン
• 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 — ラベル リスト (特定ラベルのトークン、SOL のみ)
• POST /api/trade/open/api/signal-list — シグナル リスト (AI トレンド シグナル、SOL/BSC)
• POST /api/trade/open/api/trending-list — トレンド リスト (期間別ホット トークン、SOL/BSC)
• POST /api/trade/open/api/{chain}/launch — トークン ローンチ (新トークン作成、SOL/BSC)
• 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+40hex	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+40hex	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 キー ユーザーに属する必要があります
chain	はい	文字列	sol / eth / bsc / base	チェーン識別子 (必須)
tokenAddress	いいえ	文字列	コントラクト アドレス	特定のトークンでフィルター
pageNum	いいえ	int	>= 1	ページ番号、デフォルト 1
pageSize	いいえ	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 / bsc	これら 2 つのチェーンのみサポート。デフォルト sol

ボディ (フィルター パラメータ)

すべてのフィルターはオプションです。範囲パラメータはカンマ区切り文字列形式 "min,max" を使用します。片方を空白のままにして最小値のみまたは最大値のみを設定できます (例: "100," = 最小 100、",50" = 最大 50)。

パラメータ	タイプ	説明	例
dex	文字列[]	DEX プラットフォーム フィルター	チェーン別 DEX 値を参照
quoteTokens	文字列[]	クオート トークン フィルター	チェーン別 quoteTokens 値を参照
link	文字列[]	ソーシャル メディア リンク フィルター	["x","tg","web"]
keywords	文字列[]	トークン名/シンボル キーワード マッチ	["pepe","doge"]
ignoreWords	文字列[]	キーワードを除外	["scam"]
mc	文字列	マーケット キャップ範囲 (USD)	"10000,500000"
liq	文字列	流動性範囲 (USD)	"1000,"
vol	文字列	取引量範囲 (USD)	"5000,100000"
holder	文字列	ホルダー数範囲	"50,"
createTime	文字列	作成時刻範囲 (現在からの分)	"1,20"
tradeCount	文字列	取引数範囲	"100,"
buyCount	文字列	買い数範囲	"50,"
sellCount	文字列	売り数範囲	"10,"
devBuy	文字列	デブ買い金額範囲 (ネイティブ トークン)	"0.001,"
devSell	文字列	デブ売却金額範囲 (ネイティブ トークン)	"0.001,"
devHp	文字列	デブ保有 % 範囲	",60"
topHp	文字列	Top10 保有 % 範囲	",60"
insiderHp	文字列	インサイダー保有 % 範囲	",50"
bundleHp	文字列	バンドル保有 % 範囲	",60"
newWalletHp	文字列	新規ウォレット保有 % 範囲	",30"
progress	文字列	卒業進捗 % 範囲 (NEW/ALMOST のみ)	"1,90"
snipers	文字列	スナイパー数範囲	",5"
xnameCount	文字列	Twitter リネーム数範囲	",3"
tagHolder	文字列	ウォッチ済みウォレット買い数範囲	"1,2"
kol	文字列	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	はい	文字列	コントラクト アドレス	トークン コントラクト アドレス
chain	いいえ	文字列	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: Top 10 ホルダー分布

ウォレット リスト

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

現在のユーザーのウォレット リスト (残高付き) を特定のチェーン用にクエリします。

ウォレット パラメータ

パラメータ	必須	タイプ	有効な値	説明
chain	いいえ	文字列	sol / eth / bsc / base	デフォルト sol
pageNum	いいえ	int	>= 1	ページ番号、デフォルト 1
pageSize	いいえ	int	1-20	1 ページあたりのアイテム数、デフォルト 20
tokenAddress	いいえ	文字列	コントラクト アドレス	ウォレットあたりのトークン保有量を返します

ウォレット レスポンス

{
  "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	はい	文字列	ウォレット アドレス	EVM チェーンは大文字小文字を区別しません
chain	いいえ	文字列	sol / eth / bsc / base	デフォルト sol
tokenAddress	いいえ	文字列	コントラクト アドレス	このトークンのトークン保有量を返します

ウォレット情報レスポンス

{
  "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	はい	文字列	ウォレット アドレス	現在の API キー ユーザーに属する必要があります
tokenAddress	はい	文字列	コントラクト アドレス	トークン コントラクト アドレス
chain	はい	文字列	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	いいえ	文字列	sol / bsc	デフォルト sol。SOL と BSC のみサポート

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: 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}

タグ ホルダー (スマート マネー、クジラなど) の最近の買いリストを取得します。タグ付きウォレットが最近購入したトークンを表示します。

タグ ホルダー 買いリスト パラメータ

パラメータ	必須	タイプ	有効な値	説明
chain	いいえ	文字列	sol / bsc	デフォルト sol。SOL と BSC のみサポート

タグ ホルダー 買いリスト レスポンス

{
  "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: 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 マーク付きトークンなど) のトークンを取得します。現在のところ Solana チェーンのみをサポートしています。

ラベル リスト パラメータ

パラメータ	必須	タイプ	有効な値	説明
chain	いいえ	文字列	sol / bsc	デフォルト sol。SOL と BSC をサポート
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: トークン ロゴ URL
• priceUSD: USD での現在の価格
• marketCapUSD: USD でのマーケット キャップ
• priceChange24H: 24 時間の価格変動パーセンテージ
• launchFrom: ローンチ プラットフォーム
• links: ソーシャル メディア リンク (Telegram、X/Twitter、Website)

シグナル リスト

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

AI トレンド シグナル リスト (例: open-ai-trending トークン) を取得します。SOL と BSC チェーンをサポートしています。

シグナル リスト パラメータ

パラメータ	必須	タイプ	有効な値	説明
type	いいえ	文字列	open-ai-trending	デフォルト open-ai-trending。現在のところ open-ai-trending のみをサポート
chain	いいえ	文字列	sol / bsc	デフォルト sol。SOL と BSC をサポート

リクエスト ボディ: 空の 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	いいえ	文字列	sol / bsc	デフォルト sol。SOL と BSC のみサポート
period	はい	文字列	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

SOL または BSC チェーン上に新しいトークンをローンチ (作成) します。オプションで、新規作成したトークンの初期購入額を設定できます。

パス パラメータ

パラメータ	必須	タイプ	有効な値	説明
chain	はい	文字列	sol / bsc	SOL と BSC のみサポート

ローンチ リクエスト ボディ

パラメータ	必須	タイプ	説明
walletAddress	はい	文字列	ウォレット アドレス (API キーのアカウントに属する必要があります)
name	はい	文字列	トークン名
symbol	はい	文字列	トークン シンボル
buyAmount	いいえ	文字列	初期購入用ネイティブ トークン金額。"0" = 作成のみ。デフォルト: "0"
solOptions	SOL のみ	オブジェクト	Solana チェーン固有オプション (下記参照)
bscOptions	BSC のみ	オブジェクト	BSC チェーン固有オプション (下記参照)

buyAmount 制限:

• SOL: 最大 100 SOL、最小残高 = buyAmount + 0.01 SOL
• BSC: 最大 20 BNB、最小残高 = buyAmount + 0.015 BNB

solOptions (chain=sol)

パラメータ	必須	タイプ	デフォルト	説明
uri	はい	文字列	-	メタデータ JSON URI (Metaplex 標準、name/symbol/description/image を含む)
slippage	いいえ	整数	100	スリッページをベーシス ポイント単位。100 = 1%。buyAmount > 0 の場合のみ有効
priorityFee	いいえ	long	100000	プライオリティ フィー (lamports)
tipFee	いいえ	long	100000	チップ フィー (lamports)
model	いいえ	整数	1	1 = MEV 保護、2 = 高速モード
creator	いいえ	文字列	null	クリエーター アドレス (base58)。デフォルトは署名ウォレット
mayhemMode	いいえ	ブール値	false	Pump mayhem モード
cashback	いいえ	ブール値	false	Pump キャッシュバック

プラットフォーム手数料 (1%) は buyAmount > 0 の場合に自動的に請求され、設定できません。

bscOptions (chain=bsc)

パラメータ	必須	タイプ	デフォルト	説明
desc	はい	文字列	-	トークンの説明
image	はい	文字列	-	画像 URL / base64 / data URI (≤5MB)
label	いいえ	文字列	"Meme"	カテゴリ: Meme、AI、Defi、Games、Infra、De-Sci、Social、Depin、Charity、Others
gasPrice	いいえ	文字列	null	カスタム ガス価格 (wei)。提供されない場合は自動取得
model	いいえ	整数	1	1 = MEV 保護 (バンドル)、2 = 高速モード
feePlan	いいえ	ブール値	false	手数料プラン トグル
webUrl	いいえ	文字列	""	ウェブサイト URL
twitterUrl	いいえ	文字列	""	Twitter URL
telegramUrl	いいえ	文字列	""	Telegram URL
tokenTaxInfo	いいえ	オブジェクト	null	トークン税設定 (下記参照)

tokenTaxInfo (BSC のみ)

パラメータ	必須	タイプ	説明
feeRate	はい	整数	取引手数料率。固定オプション: 1、3、5、10 (1%-10% を表す)
burnRate	はい	整数	バーン率 (0-100)
divideRate	はい	整数	配当分配率 (0-100)
liquidityRate	はい	整数	流動性プール率 (0-100)
recipientRate	はい	整数	受取人割り当て率 (0-100)
minSharing	条件付き	long	配当参加の最小トークン量 (ether 単位)。divideRate > 0 の場合は必須。形式: d × 10^n (n≥5、1≤d≤9)
recipientAddress	条件付き	文字列	受取人アドレス (0x...)。recipientRate > 0 の場合は必須

制約: burnRate + divideRate + liquidityRate + recipientRate = 100

ローンチ レスポンス

成功:

{
  "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
}

ローンチ エラー コード