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

NEVER fabricate data. Always run scripts. If data is empty or errors, say so — do NOT invent prices or balances.
NEVER use curl, web_fetch, web_search for on-chain data. Always use these scripts.
NEVER run
env
or
printenv
— leaks API secrets.
Scripts auto-load
.env
— never pass credentials inline.
Reply in user's language. Chinese input = Chinese response.
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
```
.
This skill does NOT sign transactions. It returns unsigned tx data. User must sign locally with their own wallet/key.

Quick Reference

Task	Command
Search token	`node scripts/token.mjs search '{"query":"PEPE"}'`
Token price	`node scripts/market.mjs price '{"address":"0xeee...","chain":"ethereum"}'`
K-line chart	`node scripts/market.mjs kline '{"address":"0xeee...","chain":"ethereum","bar":"1H","limit":100}'`
Trending tokens	`node scripts/token.mjs trending '{}'`
Hot tokens	`node scripts/token.mjs hot_tokens '{}'`
Swap quote	`node scripts/swap.mjs quote '{"from":"0xeee...","to":"0xdac...","amount":"1000000000000000000","chain":"ethereum"}'`
Wallet balance	`node scripts/portfolio.mjs total_value '{"address":"0x...","chains":"ethereum"}'`
All token holdings	`node scripts/portfolio.mjs all_balances '{"address":"0x...","chains":"ethereum,solana"}'`
Gas price	`node scripts/gateway.mjs gas '{"chain":"ethereum"}'`
Auto swap	`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

Action	Params	Description
`search`	`query` , `chains?`	Search tokens by name/symbol/address
`info`	`address` , `chain?`	Token metadata (name, symbol, decimals, logo)
`trending`	`chains?` , `sort_by?` , `time_frame?`	Trending token rankings
`price_info`	`address` , `chain?`	Price, market cap, liquidity, 24h change
`hot_tokens`	`chains?` , `ranking_type?`	Hot tokens by trending score
`holders`	`address` , `chain?`	Token holder distribution
`liquidity`	`address` , `chain?`	Top liquidity pools
`advanced_info`	`address` , `chain?`	Risk level, creator, dev stats

market.mjs — Market Data

Action	Params	Description
`price`	`address` , `chain?`	Current token price
`prices`	`tokens` , `chain?`	Batch price query (comma-separated chain:address)
`kline`	`address` , `chain?` , `bar?` , `limit?`	K-line / candlestick data
`index`	`address` , `chain?`	Aggregated index price
`signal_list`	`chain` , `wallet_type?` , `token_address?`	Smart money / whale / KOL signals
`signal_chains`	(none)	Supported chains for signals

swap.mjs — DEX Swap

Action	Params	Description
`quote`	`from` , `to` , `amount` , `chain` , `swap_mode?`	Get swap quote (read-only)
`swap`	`from` , `to` , `amount` , `chain` , `wallet` , `slippage?`	Get swap tx data (unsigned)
`approve`	`token` , `amount` , `chain`	Get ERC-20 approval tx data
`chains`	(none)	Supported chains for DEX aggregator
`liquidity`	`chain`	Available liquidity sources on a chain

portfolio.mjs — Wallet Portfolio

Action	Params	Description
`total_value`	`address` , `chains`	Total portfolio value in USD
`all_balances`	`address` , `chains`	All token balances
`token_balances`	`address` , `tokens`	Specific token balances
`chains`	(none)	Supported chains for balance queries

gateway.mjs — Transaction Gateway

Action	Params	Description
`gas`	`chain`	Current gas prices
`gas_limit`	`from` , `to` , `chain` , `amount?` , `data?`	Estimate gas limit
`simulate`	`from` , `to` , `data` , `chain` , `amount?`	Simulate transaction (dry-run)
`broadcast`	`signed_tx` , `address` , `chain`	Broadcast signed transaction
`orders`	`address` , `chain` , `order_id?`	Track broadcast order status
`chains`	(none)	Supported chains for gateway

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

Action	Params	Description
`swap`	`from` , `to` , `amount` , `chain` , `slippage?`	Full auto: quote → approve → sign → broadcast
`wallet_info`	(none)	Show wallet address derived from private key

Setup: User adds

WALLET_PRIVATE_KEY=0x...

.env

. Private key stays local, never sent to any server.

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:

Chain	Name	Also Accepts
Ethereum	`ethereum`	`eth`
Solana	`solana`	`sol`
Base	`base`
BSC	`bsc`	`bnb`
Arbitrum	`arbitrum`	`arb`
Polygon	`polygon`	`matic`
XLayer	`xlayer`	`okb`
Avalanche	`avalanche`	`avax`
Optimism	`optimism`	`op`

Native Token Addresses

Chain	Address
EVM (ETH, BSC, Polygon, etc.)	`0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee`
Solana	`11111111111111111111111111111111`

WARNING: Solana native SOL address is

11111111111111111111111111111111

(system program). Do NOT use

So11111111111111111111111111111111111111112

(wSOL).

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

Never execute swap without user confirmation. Show: token names, amounts, gas estimate, price impact, honeypot status.
Skip approve for native tokens. Never call
```
swap approve
```
for
```
0xeee...
```
(EVM) or
```
111...1
```
(Solana).
Honeypot warning. If
```
isHoneyPot = true
```
, warn prominently and ask user to confirm.
Price impact >5%: warn user. >10%: strongly warn, suggest reducing amount.
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.

aicoin-onchain

NPX Install

Tags

SKILL.md Content