Agent Payment X402
affaan-m/ECC
Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets.
Execute token swaps on-chain via OKX DEX Aggregator API (v6).
$ npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills okx-dex-swap --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/easy-swap .claude/skills/okx-dex-swap && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "okx-dex-swap" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swap into .claude/skills/okx-dex-swap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "okx-dex-swap", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swapType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills okx-dex-swap --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/easy-swap .agents/skills/okx-dex-swap && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "okx-dex-swap" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swap into .agents/skills/okx-dex-swap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "okx-dex-swap", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills okx-dex-swap --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/easy-swap .cursor/skills/okx-dex-swap && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "okx-dex-swap" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swap into .cursor/skills/okx-dex-swap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "okx-dex-swap", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/LeoYeAI/openclaw-master-skills.git --path skills/easy-swap--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills okx-dex-swap --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/easy-swap .gemini/skills/okx-dex-swap && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "okx-dex-swap" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swap into .gemini/skills/okx-dex-swap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "okx-dex-swap", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install LeoYeAI/openclaw-master-skills okx-dex-swapInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/easy-swap .github/skills/okx-dex-swap && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "okx-dex-swap" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swap into .github/skills/okx-dex-swap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "okx-dex-swap", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills okx-dex-swap --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/easy-swap .opencode/skills/okx-dex-swap && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "okx-dex-swap" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/easy-swap into .opencode/skills/okx-dex-swap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "okx-dex-swap", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
okx-dex-swapExecute token swaps on-chain via OKX DEX Aggregator API (v6).
Okx Dex Swap is an agent skill from LeoYeAI/openclaw-master-skills. Execute token swaps on-chain via OKX DEX Aggregator API (v6). Use this skill when a user wants to: 1. Build a complete swap flow: get swap calldata - sign transaction - broadcast to chain 2. Execute token-to-token swaps with slippage protection, MEV protection, and Jito tips (Solana) 3. Integrate OKX DEX swap + broadcast into applications, bots, or scripts This skill covers the FULL lifecycle: /swap endpoint (get tx data) + /broadcast-transaction endpoint (submit signed tx). For quote-only (no execution), use the…
Its SKILL.md is about 6.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `_meta.json` and `scripts/easy_swap.py`).
It sits in Backend & APIs, covering Smart contracts. It works with OKX and Solana. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
web3.okx.cometh.llamarpc.cometherscan.ioFrom URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
PRIVATE_KEYOKX_ACCESS_KEYOKX_SECRET_KEYAPI_KEYSECRET_KEYWALLET_PRIVATE_KEYFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Okx Dex Swap loads about 6.2k tokens when it runs. Until then it costs about 141 tokens; SKILL.md has 1,460 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 1,460 words, ~6,195 tokens.
.claude/skills/okx-dex-swap/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.This skill generates production-ready code for the complete on-chain swap flow using the OKX DEX Aggregator:
┌─────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐
│ Quote │ ──▶ │ Swap │ ──▶ │ Sign │ ──▶ │ Broadcast │
│ (optional│ │ API Call │ │ Tx │ │ to Chain │
│ preview)│ │ │ │ │ │ │
└─────────┘ └──────────┘ └──────────┘ └───────────┘Two API endpoints involved:
| Step | Endpoint | Method | Purpose |
|---|---|---|---|
| Swap | /api/v6/dex/aggregator/swap | GET | Get transaction calldata for the swap |
| Broadcast | /api/v6/dex/pre-transaction/broadcast-transaction | POST | Submit signed transaction to the chain |
Key features:
OKX_ACCESS_KEY — API keyOKX_SECRET_KEY — Secret key for HMAC signingOKX_PASSPHRASE — Account passphrasefromToken and native token for gasrequests, web3 (for EVM signing), solders / solana-py (for Solana)axios, ethers (for EVM signing), @solana/web3.js (for Solana)Endpoint:
GET https://web3.okx.com/api/v6/dex/aggregator/swapRequired parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
chainIndex | String | Yes | Chain ID (e.g., 1 = Ethereum, 501 = Solana) |
amount | String | Yes | Amount in raw units with decimals (e.g., 1000000 for 1 USDT) |
swapMode | String | Yes | exactIn (default) or exactOut |
fromTokenAddress | String | Yes | Sell token contract address |
toTokenAddress | String | Yes | Buy token contract address |
slippagePercent | String | Yes | Slippage tolerance (e.g., 0.5 = 0.5%). EVM: 0-100, Solana: 0 to <100 |
userWalletAddress | String | Yes | User's wallet address that will sign and send the tx |
Important optional parameters:
| Parameter | Type | Description |
|---|---|---|
approveTransaction | Boolean | Set true to get ERC-20 approval calldata in response |
approveAmount | String | Custom approval amount (raw units). If omitted, approves exact swap amount |
swapReceiverAddress | String | Recipient address if different from sender |
feePercent | String | Commission fee %. Max 3% (EVM) / 10% (Solana) |
fromTokenReferrerWalletAddress | String | Wallet to receive fromToken commission |
toTokenReferrerWalletAddress | String | Wallet to receive toToken commission |
autoSlippage | Boolean | Auto-calculate optimal slippage (overrides slippagePercent) |
maxAutoslippagePercent | String | Cap for auto-slippage |
priceImpactProtectionPercent | String | Max price impact allowed (0-100, default 90) |
gasLevel | String | slow, average (default), or fast |
gaslimit | String | Custom gas limit in wei (EVM only) |
dexIds | String | Restrict to specific DEX IDs (comma-separated) |
excludeDexIds | String | Exclude specific DEX IDs (comma-separated) |
directRoute | Boolean | Single-pool routing only (Solana only) |
disableRFQ | String | Disable time-sensitive RFQ liquidity sources |
callDataMemo | String | Custom 64-byte hex data to include on-chain |
Solana-specific parameters:
| Parameter | Type | Description |
|---|---|---|
computeUnitPrice | String | Priority fee (like gasPrice on EVM) |
computeUnitLimit | String | Compute budget (like gasLimit on EVM) |
tips | String | Jito tips in SOL (min 0.0000000001, max 2). Set computeUnitPrice=0 when using tips |
Swap API response structure:
{
"code": "0",
"data": [{
"routerResult": {
"chainIndex": "1",
"fromToken": { "tokenSymbol": "USDC", "decimal": "6", ... },
"toToken": { "tokenSymbol": "WBTC", "decimal": "8", ... },
"fromTokenAmount": "100000000000",
"toTokenAmount": "90281915",
"tradeFee": "1.35",
"estimateGasFee": "1248837",
"priceImpactPercent": "0.07",
"dexRouterList": [...]
},
"tx": {
"from": "0x77660f...",
"to": "0x5E1f62...",
"value": "0",
"data": "0xf2c42696...",
"gas": "1248837",
"gasPrice": "557703374",
"maxPriorityFeePerGas": "500000000",
"minReceiveAmount": "90191633",
"slippagePercent": "0.1",
"signatureData": [...]
}
}],
"msg": ""
}Key fields in tx object:
| Field | Description |
|---|---|
from | Sender wallet address |
to | OKX DEX router contract address |
data | Transaction calldata (the swap instruction) |
value | Native token amount to send (in wei). "0" for ERC-20 swaps |
gas | Estimated gas limit (already padded +50%) |
gasPrice | Gas price in wei |
maxPriorityFeePerGas | EIP-1559 priority fee |
minReceiveAmount | Minimum output at max slippage |
signatureData | Approval calldata (if approveTransaction=true) or Jito tips calldata |
For ERC-20 tokens (not native ETH/BNB), you need to approve the DEX router to spend your tokens BEFORE the swap.
When approveTransaction=true in the request:
The response tx.signatureData contains the approval info:
{
"approveContract": "0x40aA958dd87FC8305b97f2BA922CDdCa374bcD7f",
"approveTxCalldata": "0x095ea7b3..."
}Approval flow:
signatureData to get approveContract and approveTxCalldatato=approveContract, data=approveTxCalldataIMPORTANT: For native tokens (ETH, BNB, etc. using 0xeeee...eeee), no approval is needed.
EVM chains (Python / web3.py):
tx_params = {
"from": tx_data["from"],
"to": tx_data["to"],
"value": int(tx_data["value"]),
"data": tx_data["data"],
"gas": int(tx_data["gas"]),
"gasPrice": int(tx_data["gasPrice"]),
"nonce": w3.eth.get_transaction_count(wallet_address),
"chainId": chain_id,
}
signed = w3.eth.account.sign_transaction(tx_params, private_key)
signed_tx_hex = signed.raw_transaction.hex()EVM chains (Node.js / ethers.js):
const tx = {
from: txData.from,
to: txData.to,
value: txData.value,
data: txData.data,
gasLimit: txData.gas,
gasPrice: txData.gasPrice,
nonce: await provider.getTransactionCount(walletAddress),
chainId: chainId,
};
const signedTx = await wallet.signTransaction(tx);Solana:
Use solders or @solana/web3.js to deserialize, sign, and serialize the transaction from tx.data.
Endpoint:
POST https://web3.okx.com/api/v6/dex/pre-transaction/broadcast-transactionIMPORTANT: This is a POST request with a JSON body (unlike the GET-based swap/quote endpoints).
Request body:
| Parameter | Type | Required | Description |
|---|---|---|---|
signedTx | String | Yes | The hex-encoded signed transaction string |
chainIndex | String | Yes | Chain ID (e.g., "1" for Ethereum) |
address | String | Yes | Sender wallet address |
extraData | String | No | JSON string with extra options (see below) |
extraData options (JSON string):
| Field | Type | Description |
|---|---|---|
enableMevProtection | Boolean | Enable MEV (sandwich) protection. Supported: ETH, BSC, SOL, BASE |
jitoSignedTx | String | Base58-encoded signed Jito transaction (Solana only). Required when tips > 0 |
Signing algorithm for POST requests:
prehash = timestamp + "POST" + request_path + json_body
signature = Base64(HMAC-SHA256(secret_key, prehash))Note: For POST, the request_path has NO query string. The JSON body is appended directly to the prehash string.
Broadcast response:
{
"code": "0",
"data": [{
"orderId": "0e1d79837afce1e149b6ab54b6e2edce8130c3f8",
"txHash": "0xd394f356a16b618ed839c66c935c9cccc5dde0af832ff9b468677eea38759db5"
}],
"msg": ""
}| Field | Description |
|---|---|
orderId | OKX internal order tracking ID |
txHash | On-chain transaction hash. Use this to check status on block explorer |
After broadcasting, verify the transaction was confirmed:
txHash on Etherscan / block explorer, or use web3.eth.wait_for_transaction_receipt()connection.confirmTransaction()isHoneyPot on both tokens before proceeding.priceImpactProtectionPercent (recommend setting to 10 or lower for safety).0.1% - 0.5%0.5% - 1%1% - 5%5% - 15% (or higher, but be cautious)autoSlippage=true with maxAutoslippagePercent for optimal auto-calculation.enableMevProtection: true for large trades on ETH, BSC, SOL, BASE.computeUnitPrice=0 to avoid wasting fees.approveAmount = swap amount).When swapping through Uniswap V3 pools, if the liquidity for the pair is drained mid-swap, the router will only consume part of your input tokens. The OKX DEX Router smart contract will automatically refund the remainder. Ensure your integration contract supports receiving token refunds.
int() for calculations, never float().BigInt or ethers.parseUnits() for amounts.raw_amount = human_amount * 10^decimalsresponse["code"] == "0" before processing.401 = Signature mismatch (check POST signing includes body)429 = Rate limitedfromTokenReferrerWalletAddress or toTokenReferrerWalletAddress per tx.import os, hmac, hashlib, base64, json, requests
from datetime import datetime, timezone
from urllib.parse import urlencode
from web3 import Web3
# === Configuration ===
API_KEY = os.environ["OKX_ACCESS_KEY"]
SECRET_KEY = os.environ["OKX_SECRET_KEY"]
PASSPHRASE = os.environ["OKX_PASSPHRASE"]
PRIVATE_KEY = os.environ["WALLET_PRIVATE_KEY"]
BASE_URL = "https://web3.okx.com"
CHAIN_INDEX = "1" # Ethereum
CHAIN_ID = 1
RPC_URL = "https://eth.llamarpc.com"
w3 = Web3(Web3.HTTPProvider(RPC_URL))
account = w3.eth.account.from_key(PRIVATE_KEY)
WALLET = account.address
def _sign_request(timestamp, method, request_path, body=""):
prehash = timestamp + method + request_path + body
mac = hmac.new(SECRET_KEY.encode(), prehash.encode(), hashlib.sha256)
return base64.b64encode(mac.digest()).decode()
def _headers(method, request_path, body=""):
timestamp = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] + "Z"
sig = _sign_request(timestamp, method, request_path, body)
return {
"OK-ACCESS-KEY": API_KEY,
"OK-ACCESS-SIGN": sig,
"OK-ACCESS-PASSPHRASE": PASSPHRASE,
"OK-ACCESS-TIMESTAMP": timestamp,
"Content-Type": "application/json",
}
# --- Step 1: Get swap calldata ---
def get_swap_data(from_token, to_token, amount, slippage="0.5"):
params = {
"chainIndex": CHAIN_INDEX,
"fromTokenAddress": from_token,
"toTokenAddress": to_token,
"amount": amount,
"swapMode": "exactIn",
"slippagePercent": slippage,
"userWalletAddress": WALLET,
"approveTransaction": "true",
}
query = urlencode(params)
path = f"/api/v6/dex/aggregator/swap?{query}"
headers = _headers("GET", path)
resp = requests.get(BASE_URL + path, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
if data["code"] != "0":
raise Exception(f"Swap API error: {data['msg']}")
return data["data"][0]
# --- Step 2: Handle approval (if needed) ---
def send_approval_if_needed(swap_result):
sig_data = swap_result["tx"].get("signatureData", [])
if not sig_data:
return None
for item in sig_data:
parsed = json.loads(item) if isinstance(item, str) else item
if "approveContract" in parsed:
approve_tx = {
"from": WALLET,
"to": Web3.to_checksum_address(parsed["approveContract"]),
"data": parsed["approveTxCalldata"],
"gas": 60000,
"gasPrice": w3.eth.gas_price,
"nonce": w3.eth.get_transaction_count(WALLET),
"chainId": CHAIN_ID,
}
signed = w3.eth.account.sign_transaction(approve_tx, PRIVATE_KEY)
tx_hash = w3.eth.send_raw_transaction(signed.raw_transaction)
receipt = w3.eth.wait_for_transaction_receipt(tx_hash, timeout=120)
print(f"Approval confirmed: {tx_hash.hex()}")
return receipt
return None
# --- Step 3: Sign the swap transaction ---
def sign_swap_tx(swap_result):
tx_data = swap_result["tx"]
tx_params = {
"from": Web3.to_checksum_address(tx_data["from"]),
"to": Web3.to_checksum_address(tx_data["to"]),
"value": int(tx_data["value"]),
"data": tx_data["data"],
"gas": int(tx_data["gas"]),
"gasPrice": int(tx_data["gasPrice"]),
"nonce": w3.eth.get_transaction_count(WALLET),
"chainId": CHAIN_ID,
}
signed = w3.eth.account.sign_transaction(tx_params, PRIVATE_KEY)
return signed.raw_transaction.hex()
# --- Step 4: Broadcast via OKX ---
def broadcast_tx(signed_tx_hex, enable_mev=True):
path = "/api/v6/dex/pre-transaction/broadcast-transaction"
body_dict = {
"chainIndex": CHAIN_INDEX,
"address": WALLET,
"signedTx": signed_tx_hex,
}
if enable_mev:
body_dict["extraData"] = json.dumps({"enableMevProtection": True})
body_str = json.dumps(body_dict)
headers = _headers("POST", path, body_str)
resp = requests.post(BASE_URL + path, headers=headers, data=body_str, timeout=30)
resp.raise_for_status()
data = resp.json()
if data["code"] != "0":
raise Exception(f"Broadcast error: {data['msg']}")
return data["data"][0]
# === Execute full swap ===
if __name__ == "__main__":
ETH = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
USDC = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
amount = str(10 ** 17) # 0.1 ETH
print("1. Getting swap data...")
swap = get_swap_data(ETH, USDC, amount, slippage="0.5")
router = swap["routerResult"]
to_dec = int(router["toToken"]["decimal"])
out_human = int(router["toTokenAmount"]) / (10 ** to_dec)
print(f" Expected output: {out_human:,.2f} {router['toToken']['tokenSymbol']}")
print(f" Price impact: {router.get('priceImpactPercent', 'N/A')}%")
print(f" Min receive: {int(swap['tx']['minReceiveAmount']) / (10 ** to_dec):,.2f}")
# Honeypot check
if router["toToken"].get("isHoneyPot"):
print(" HONEYPOT DETECTED — aborting!")
exit(1)
print("2. Handling approval...")
send_approval_if_needed(swap)
print("3. Signing swap transaction...")
signed_hex = sign_swap_tx(swap)
print("4. Broadcasting with MEV protection...")
result = broadcast_tx(signed_hex, enable_mev=True)
print(f" Order ID: {result['orderId']}")
print(f" Tx Hash: {result['txHash']}")
print(f" View: https://etherscan.io/tx/{result['txHash']}")const crypto = require("crypto");
const https = require("https");
const { ethers } = require("ethers");
const API_KEY = process.env.OKX_ACCESS_KEY;
const SECRET_KEY = process.env.OKX_SECRET_KEY;
const PASSPHRASE = process.env.OKX_PASSPHRASE;
const PRIVATE_KEY = process.env.WALLET_PRIVATE_KEY;
const BASE_URL = "https://web3.okx.com";
const CHAIN_INDEX = "1";
const CHAIN_ID = 1;
const provider = new ethers.JsonRpcProvider("https://eth.llamarpc.com");
const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
function sign(timestamp, method, path, body = "") {
return crypto
.createHmac("sha256", SECRET_KEY)
.update(timestamp + method + path + body)
.digest("base64");
}
function headers(method, path, body = "") {
const ts = new Date().toISOString();
return {
"OK-ACCESS-KEY": API_KEY,
"OK-ACCESS-SIGN": sign(ts, method, path, body),
"OK-ACCESS-PASSPHRASE": PASSPHRASE,
"OK-ACCESS-TIMESTAMP": ts,
"Content-Type": "application/json",
};
}
async function getSwapData(fromToken, toToken, amount, slippage = "0.5") {
const params = new URLSearchParams({
chainIndex: CHAIN_INDEX,
fromTokenAddress: fromToken,
toTokenAddress: toToken,
amount,
swapMode: "exactIn",
slippagePercent: slippage,
userWalletAddress: wallet.address,
approveTransaction: "true",
});
const path = `/api/v6/dex/aggregator/swap?${params}`;
const h = headers("GET", path);
const resp = await fetch(`${BASE_URL}${path}`, { headers: h });
const data = await resp.json();
if (data.code !== "0") throw new Error(`Swap error: ${data.msg}`);
return data.data[0];
}
async function broadcastTx(signedTx, enableMev = true) {
const path = "/api/v6/dex/pre-transaction/broadcast-transaction";
const bodyObj = {
chainIndex: CHAIN_INDEX,
address: wallet.address,
signedTx,
...(enableMev && {
extraData: JSON.stringify({ enableMevProtection: true }),
}),
};
const bodyStr = JSON.stringify(bodyObj);
const h = headers("POST", path, bodyStr);
const resp = await fetch(`${BASE_URL}${path}`, {
method: "POST",
headers: h,
body: bodyStr,
});
const data = await resp.json();
if (data.code !== "0") throw new Error(`Broadcast error: ${data.msg}`);
return data.data[0];
}
async function main() {
const ETH = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
const USDC = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48";
const amount = (10n ** 17n).toString(); // 0.1 ETH
console.log("1. Getting swap data...");
const swap = await getSwapData(ETH, USDC, amount);
const txData = swap.tx;
console.log(` Min receive: ${txData.minReceiveAmount}`);
console.log("2. Signing transaction...");
const tx = {
from: txData.from,
to: txData.to,
value: txData.value,
data: txData.data,
gasLimit: txData.gas,
gasPrice: txData.gasPrice,
nonce: await provider.getTransactionCount(wallet.address),
chainId: CHAIN_ID,
};
const signedTx = await wallet.signTransaction(tx);
console.log("3. Broadcasting with MEV protection...");
const result = await broadcastTx(signedTx);
console.log(` Tx Hash: ${result.txHash}`);
}
main().catch(console.error);When using Jito tips on Solana:
tips parameter (e.g., "0.001" SOL) in the swap requestcomputeUnitPrice=0 (avoid double-paying for priority)signatureData in response contains the Jito tips calldatasignedTx and jitoSignedTx in extraData# Solana-specific broadcast with Jito
body = {
"chainIndex": "501",
"address": solana_wallet_pubkey,
"signedTx": base58_signed_main_tx,
"extraData": json.dumps({
"enableMevProtection": True,
"jitoSignedTx": base58_signed_jito_tx
})
}IMPORTANT: For Solana, signedTx and jitoSignedTx must BOTH be provided when using tips.
| Problem | Cause | Solution |
|---|---|---|
401 Unauthorized on broadcast | POST signing error | Ensure prehash = timestamp + "POST" + path + jsonBody. The body must be the exact JSON string. |
401 Unauthorized on swap | GET signing error | Ensure prehash = timestamp + "GET" + path_with_query_string. |
| Approval tx fails | Insufficient ETH for gas | Ensure wallet has native token for gas fees. |
| Swap tx reverts | Slippage exceeded | Increase slippagePercent or use autoSlippage=true. |
minReceiveAmount is 0 | Extreme slippage or bad params | Check token addresses and amounts. Reduce trade size. |
| Broadcast returns no txHash | MEV protection routing delay | Wait and check orderId status. MEV-protected txs may take longer. |
| "Nonce too low" on broadcast | Tx already sent or nonce reused | Fetch fresh nonce before signing. Never reuse nonces. |
| Solana broadcast fails | Missing jitoSignedTx | When tips > 0, you must provide both signedTx and jitoSignedTx. |
| Token refund not received | Uni V3 liquidity drained | Ensure your contract supports receiving token refunds from the router. |
| Commission not working on BSC | Four.meme restriction | Commission is not supported for swaps through Four.meme on BSC. |
priceImpactPercent very negative | Low liquidity | Reduce amount or split into multiple smaller swaps. |
The OKX API uses different signing for GET and POST:
| Method | Prehash Format |
|---|---|
| GET | timestamp + "GET" + path_with_query |
| POST | timestamp + "POST" + path + json_body |
The Swap endpoint is GET, the Broadcast endpoint is POST. Getting this wrong is the #1 cause of 401 errors.
| Chain | enableMevProtection | Jito Tips |
|---|---|---|
| Ethereum | Yes | No |
| BSC | Yes | No |
| Solana | Yes | Yes |
| Base | Yes | No |
| Others | Not yet | Not yet |
| Chain | chainIndex | Chain ID (for tx signing) |
|---|---|---|
| Ethereum | 1 | 1 |
| BSC | 56 | 56 |
| Polygon | 137 | 137 |
| Arbitrum | 42161 | 42161 |
| Optimism | 10 | 10 |
| Base | 8453 | 8453 |
| Avalanche | 43114 | 43114 |
| Solana | 501 | N/A |
| Unichain | 130 | 130 |
© LeoYeAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files (scripts) in skills/easy-swap of LeoYeAI/openclaw-master-skills.
Open the folder on GitHubat commit e5199b5
Okx Dex Swap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Okx Dex Swap this skillLeoYeAI/openclaw-master-skills | 2.2k | — | ~6.2k | Automated safety check: Pass | MIT | |
| Agent Payment X402affaan-m/ECC | 276k | — | ~6.8k | Automated safety check: Pass | MIT | |
| Agent Payment X402affaan-m/ECC | 276k | — | ~4.9k | Automated safety check: Pass | MIT | |
| Agent Payment X402affaan-m/ECC | 276k | — | ~5.4k | Automated safety check: Pass | MIT | |
| Okx Dex Trenchesnirholas/three.ws | 229 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Solana Devsolana-foundation/solana-dev-skill | 573 | — | ~3.8k | Automated safety check: Pass | MIT |
affaan-m/ECC
Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets.
affaan-m/ECC
将 x402 支付执行添加到 AI 代理中,具备每任务预算、支出控制和非托管钱包。通过 agentwallet-sdk 支持 Base,通过 OKX Payments / OKX 代理支付协议支持 X Layer,并通过上游 x402 包与基于结算器的结算支持 Solana 及多网络 EVM。
affaan-m/ECC
タスクごとのバジェット、支出コントロール、ノンカストディアルウォレットを備えた x402 決済実行を AI エージェントに追加します。agentwallet-sdk を通じて Base を、OKX Payments / OKX エージェント決済プロトコルを通じて X Layer を、アップストリームの x402 パッケージとファシリテーターベースの決済を通じて Solana…
nirholas/three.ws
Read-only on-chain research for pump.fun and other meme-token launchpads (Solana / BSC / X Layer / TRON).
solana-foundation/solana-dev-skill
A skill your agent uses when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "fuzz my…
Auditware/radar
Use radar for smart contract security analysis, AST generation, and detection template development.
LeoYeAI/openclaw-master-skills
Manages pipelines on a DevOps quality and efficiency platform through its OpenAPI: list workspaces and templates, create, update, run and cancel pipelines, and read run records.
LeoYeAI/openclaw-master-skills
Patches OpenClaw's Feishu extension so an edited document triggers an isolated agent session that reads the doc and replies inline, turning it into a live chat space.
LeoYeAI/openclaw-master-skills
Multi-context memory management system for OpenClaw agents with group-isolated storage, global shared memory, workspace organization, and group-specific skills isolation.
LeoYeAI/openclaw-master-skills
Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.
LeoYeAI/openclaw-master-skills
Installs and authenticates the gws CLI, then automates Gmail, Drive, Sheets, Calendar, Docs, Chat and Tasks with ready-made recipes, persona bundles and security audits.
LeoYeAI/openclaw-master-skills
Runs four advisor roles, a fitness coach, nutritionist, data analyst and TCM practitioner, to build a health profile and track workouts, diet and wellness over time.
Categories
Execute token swaps on-chain via OKX DEX Aggregator API (v6). Okx Dex Swap is an agent skill from LeoYeAI/openclaw-master-skills. Execute token swaps on-chain via OKX DEX Aggregator API (v6).
Okx Dex Swap fits situations like: A user wants to: 1; tasks that involve Smart contracts.
Run `npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a claude-code`. Or copy the skill folder (skills/easy-swap in LeoYeAI/openclaw-master-skills) into .claude/skills/okx-dex-swap in your project. Claude Code loads it when a task matches its description.
Run `npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a codex`. Or copy the skill folder (skills/easy-swap in LeoYeAI/openclaw-master-skills) into .agents/skills/okx-dex-swap in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill okx-dex-swap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/okx-dex-swap, .gemini/skills/okx-dex-swap, .github/skills/okx-dex-swap and .opencode/skills/okx-dex-swap in your project.
Going by SKILL.md and its folder, Okx Dex Swap needs Python for the scripts in its folder and credentials named PRIVATE_KEY, OKX_ACCESS_KEY, OKX_SECRET_KEY and API_KEY. Our summary lists: Python 3; Node.js; A credential in OKX_ACCESS_KEY; A credential in OKX_SECRET_KEY.
SKILL.md names 3 domains. In commands or code: web3.okx.com, eth.llamarpc.com and etherscan.io; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Okx Dex Swap is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 6.2k tokens (SKILL.md is roughly 25k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Okx Dex Swap: Agent Payment X402 (affaan-m/ECC, 276k stars), Agent Payment X402 (affaan-m/ECC, 276k stars), Agent Payment X402 (affaan-m/ECC, 276k stars) and Okx Dex Trenches (nirholas/three.ws, 229 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,161 GitHub stars. The repository holds 1,235 skills in this directory. The repository was last updated on July 20, 2026.
Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.