xxyy-trade

XXYY Trade

On-chain token trading and data queries on Solana, Ethereum, BSC, and Base via XXYY Open API.

Prerequisites

Set environment variables before use:

• XXYY_API_KEY (required) -- Your XXYY Open API Key (format: xxyy_ak_xxxx). Get one at https://www.xxyy.io/apikey
• XXYY_API_BASE_URL (optional) -- API base URL, defaults to https://www.xxyy.io

Authentication

All requests require header: Authorization: Bearer $XXYY_API_KEY

Security Notes

• ⚠️ API Key = Wallet access -- Your XXYY API Key can execute real on-chain trades using your wallet balance. If it leaks, anyone can buy/sell tokens with your funds. Never share it, never commit it to version control, never expose it in logs or public channels. If you suspect a leak, regenerate the key immediately at https://xxyy.io.
• Custodial trading model -- XXYY is a custodial trading platform. You only provide your wallet address (public key) and API Key. No private keys or wallet signing are needed -- XXYY executes trades on your behalf through their platform.
• No read-only mode -- The same API Key is used for both data queries (Feed, Token Query) and trading (Buy, Sell). There is currently no separate read-only key.

API Reference

STRICT: Only the endpoints listed below exist. Do NOT guess, infer, or construct any URL that is not explicitly documented here. If you need functionality not covered below, tell the user it is not supported.

Complete endpoint list:

• POST /api/trade/open/api/swap — Buy / Sell
• GET /api/trade/open/api/trade — Query Trade
• GET /api/trade/open/api/ping — Ping
• POST /api/trade/open/api/feed/{type} — Feed Scan
• GET /api/trade/open/api/query — Token Query
• GET /api/trade/open/api/wallets — List Wallets
• GET /api/trade/open/api/wallet/info — Wallet Info

Buy Token

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.001,
  "slippage": 20
}

Buy Parameters

Param	Required	Type	Valid values	Description
chain	YES	string	sol / eth / bsc / base	Only these 4 values accepted
walletAddress	YES	string	SOL: Base58 32-44 chars; EVM: 0x+40hex	Wallet address on XXYY platform, must match chain
tokenAddress	YES	string	Valid contract address	Token contract address to buy
isBuy	YES	boolean	true	Must be true for buy
amount	YES	number	> 0	Amount in native currency (SOL/ETH/BNB)
tip	YES	number	SOL: 0.001-0.1 (unit: SOL); EVM: 0.1-100 (unit: Gwei)	Priority fee for all chains. If not provided, falls back to priorityFee
slippage	NO	number	0-100	Slippage tolerance %, default 20
model	NO	number	1 or 2	1=anti-sandwich (default), 2=fast mode
priorityFee	NO	number	>= 0	Solana chain only. Extra priority fee in addition to tip

Sell Token

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.001
}

Sell Parameters

Param	Required	Type	Valid values	Description
chain	YES	string	sol / eth / bsc / base	Only these 4 values accepted
walletAddress	YES	string	SOL: Base58 32-44 chars; EVM: 0x+40hex	Wallet address on XXYY platform, must match chain
tokenAddress	YES	string	Valid contract address	Token contract address to sell
isBuy	YES	boolean	false	Must be false for sell
amount	YES	number	1-100	Sell percentage. Example: 50 = sell 50% of holdings
tip	YES	number	SOL: 0.001-0.1 (unit: SOL); EVM: 0.1-100 (unit: Gwei)	Priority fee for all chains. If not provided, falls back to priorityFee
slippage	NO	number	0-100	Slippage tolerance %, default 20
model	NO	number	1 or 2	1=anti-sandwich (default), 2=fast mode
priorityFee	NO	number	>= 0	Solana chain only. Extra priority fee in addition to tip

tip / priorityFee Rules

• tip (required) -- Universal priority fee for ALL chains. EVM chains (eth/bsc/base) use tip as the priority fee. If tip is not provided, the API falls back to priorityFee.
  • SOL chain: unit is SOL (1 = 1 SOL, very expensive). Recommended range: 0.001 - 0.1
  • EVM chains (eth/bsc/base): unit is Gwei. Recommended range: 0.1 - 100
• priorityFee (optional) -- Only effective on Solana chain. Solana supports both tip and priorityFee simultaneously.

Query Trade

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

Response fields: txId, status (pending/success/failed), statusDesc, chain, tokenAddress, walletAddress, isBuy, baseAmount, quoteAmount

Ping

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

Returns "pong" if API key is valid.

Feed (Scan Tokens)

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

Retrieve Meme token lists: newly launched, almost graduated, or graduated.

Path & Query Parameters

Param	Required	Type	Valid values	Description
type	YES	path string	NEW / ALMOST / COMPLETED	NEW = newly launched, ALMOST = almost graduated, COMPLETED = graduated
chain	NO	query string	sol / bsc	Only these 2 chains supported. Default sol

Body (Filter Parameters)

All filters are optional. Range parameters use comma-separated string format "min,max". Leave one side empty to set only min or max (e.g. "100," = min 100, ",50" = max 50).

Param	Type	Description	Example
dex	string[]	DEX platform filter	See DEX Values by Chain below
quoteTokens	string[]	Quote token filter	See quoteTokens Values by Chain below
link	string[]	Social media link filter	["x","tg","web"]
keywords	string[]	Token name/symbol keyword match	["pepe","doge"]
ignoreWords	string[]	Ignore keywords	["scam"]
mc	string	Market cap range (USD)	"10000,500000"
liq	string	Liquidity range (USD)	"1000,"
vol	string	Trading volume range (USD)	"5000,100000"
holder	string	Holder count range	"50,"
createTime	string	Creation time range (minutes from now)	"1,20"
tradeCount	string	Trade count range	"100,"
buyCount	string	Buy count range	"50,"
sellCount	string	Sell count range	"10,"
devBuy	string	Dev buy amount range (native token)	"0.001,"
devSell	string	Dev sell amount range (native token)	"0.001,"
devHp	string	Dev holding % range	",60"
topHp	string	Top10 holding % range	",60"
insiderHp	string	Insider holding % range	",50"
bundleHp	string	Bundle holding % range	",60"
newWalletHp	string	New wallet holding % range	",30"
progress	string	Graduation progress % range (NEW/ALMOST only)	"1,90"
snipers	string	Sniper count range	",5"
xnameCount	string	Twitter rename count range	",3"
tagHolder	string	Watched wallet buy count range	"1,2"
kol	string	KOL buy count range	"1,2"
dexPay	int	DexScreener paid, 1 = filter paid only	1
oneLink	int	At least one social link, 1 = enabled	1
live	int	Currently live streaming, 1 = filter live	1

DEX Values by Chain