Working directory:

cd

to this SKILL.md directory before running scripts. Example:

cd ~/.openclaw/workspace/skills/aicoin-onchain && node scripts/token.mjs ...

AiCoin Onchain

On-chain DEX toolkit powered by OKX Web3 DEX API. Token discovery, swap execution, wallet portfolio, gas estimation, and transaction broadcasting across 20+ blockchains.

Version: 1.0.0

Critical Rules

1. NEVER fabricate data. Always run scripts. If data is empty or errors, say so — do NOT invent prices or balances.
2. NEVER use curl, web_fetch, web_search for on-chain data. Always use these scripts.
3. NEVER run

   env

   or

   printenv

   — leaks API secrets.
4. Scripts auto-load

   .env

   — never pass credentials inline.
5. Reply in user's language. Chinese input = Chinese response.
6. User confirmation required before swap execution. Always show quote details (amount, gas, price impact, honeypot status) and get explicit user approval before calling

   swap swap

   .
7. This skill does NOT sign transactions. It returns unsigned tx data. User must sign locally with their own wallet/key.

Quick Reference

node scripts/token.mjs search '{"query":"PEPE"}'

node scripts/market.mjs price '{"address":"0xeee...","chain":"ethereum"}'

node scripts/market.mjs kline '{"address":"0xeee...","chain":"ethereum","bar":"1H","limit":100}'

node scripts/token.mjs trending '{}'

node scripts/token.mjs hot_tokens '{}'

node scripts/swap.mjs quote '{"from":"0xeee...","to":"0xdac...","amount":"1000000000000000000","chain":"ethereum"}'

node scripts/portfolio.mjs total_value '{"address":"0x...","chains":"ethereum"}'

node scripts/portfolio.mjs all_balances '{"address":"0x...","chains":"ethereum,solana"}'

node scripts/gateway.mjs gas '{"chain":"ethereum"}'

node scripts/trade.mjs swap '{"from":"0xeee...","to":"0xdac...","amount":"1000000000000000000","chain":"base"}'

Skill Routing

• CEX trading (buy/sell on Binance, OKX) → use

  aicoin-trading

• CEX market data (funding rates, OI, liquidation maps) → use

  aicoin-market

• Freqtrade strategies → use

  aicoin-freqtrade

• Hyperliquid whales → use

  aicoin-hyperliquid

• On-chain DEX operations → use this skill (

  aicoin-onchain

  )

Scripts

token.mjs — Token Discovery

search

query

chains?

info

address

chain?

trending

chains?

sort_by?

time_frame?

price_info

address

chain?

hot_tokens

chains?

ranking_type?

holders

address

chain?

liquidity

address

chain?

advanced_info

address

chain?

market.mjs — Market Data

price

address

chain?

prices

tokens

chain?

kline

address

chain?

bar?

limit?

index

address

chain?

signal_list

chain

wallet_type?

token_address?

signal_chains

swap.mjs — DEX Swap

quote

from

to

amount

chain

swap_mode?

swap

from

to

amount

chain

wallet

slippage?

approve

token

amount

chain

chains

liquidity

chain

portfolio.mjs — Wallet Portfolio

total_value

address

chains

all_balances

address

chains

token_balances

address

tokens

chains

gateway.mjs — Transaction Gateway

gas

chain

gas_limit

from

to

chain

amount?

data?

simulate

from

to

data

chain

amount?

broadcast

signed_tx

address

chain

orders

address

chain

order_id?

chains

trade.mjs — Full Auto Trade (optional, requires private key)

swap

from

to

amount

chain

slippage?

wallet_info

Setup: User adds

WALLET_PRIVATE_KEY=0x...

.env

Safety: Auto-blocks honeypot tokens and trades with >10% price impact.

EVM only — Solana auto-trade not yet supported.

Chain Names

The scripts accept human-readable chain names:

ethereum

eth

solana

sol

base

bsc

bnb

arbitrum

arb

polygon

matic

xlayer

okb

avalanche

avax

optimism

op

Native Token Addresses

0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

11111111111111111111111111111111

WARNING: Solana native SOL address is

11111111111111111111111111111111

So11111111111111111111111111111111111111112

Swap Workflow

EVM Swap (quote → approve → swap)

1. token.mjs search    → find token contract address
2. swap.mjs quote      → get price estimate, check honeypot/tax
3. swap.mjs approve    → get ERC-20 approval tx data (skip for native tokens)
4. User signs approval → broadcast via gateway.mjs
5. swap.mjs swap       → get swap tx data
6. User signs swap     → broadcast via gateway.mjs
7. gateway.mjs orders  → track transaction status

Solana Swap (simpler, no approve step)

1. token.mjs search    → find token address
2. swap.mjs quote      → get quote
3. swap.mjs swap       → get tx data
4. User signs          → broadcast via gateway.mjs

Security Rules

1. Never execute swap without user confirmation. Show: token names, amounts, gas estimate, price impact, honeypot status.
2. Skip approve for native tokens. Never call

   swap approve

   for

   0xeee...

   (EVM) or

   111...1

   (Solana).
3. Honeypot warning. If

   isHoneyPot = true

   , warn prominently and ask user to confirm.
4. Price impact >5%: warn user. >10%: strongly warn, suggest reducing amount.
5. Tax tokens: if

   taxRate

   > 0, show to user before confirmation.

Amount Rules

• Script params use minimal units (wei/lamports):

  1 ETH

  =

  "1000000000000000000"

  ,

  1 USDC

  =

  "1000000"

• Display to user in UI units:

  1.5 ETH

  ,

  3200 USDC

• Gas fees in Gwei (EVM) or USD

API Key Setup

Requires OKX Web3 API credentials. Free at OKX Developer Portal.

Add to

.env

OKX_API_KEY=your-api-key
OKX_SECRET_KEY=your-secret-key
OKX_PASSPHRASE=your-passphrase

Security notice: OKX Web3 API Key is for reading market data and generating unsigned swap calldata. It cannot access your wallet funds or sign transactions. All signing happens locally.