/okx-agentic-wallet

name: okx-agentic-wallet
description: "Operate OKX Onchain OS wallets and execute or inspect on-chain transactions. Use for wallet login/status/accounts/addresses/balances/holdings; receive/send/transfer; swaps, bridges, limit orders, contract calls, gas estimation, simulation, broadcast, and tracking; Bitcoin UTXO/BRC-20/inscriptions; signing, approvals, wallet policy/export, public-address portfolios, security checks, and audit logs."
license: MIT
metadata:
  author: okx
  version: "4.6.3"
  homepage: "https://web3.okx.com"

OKX Agentic Wallet

Wallet and on-chain execution skill using the `onchainos` CLI. It covers wallet lifecycle, Gas Station, DEX swaps, cross-chain bridges, limit-order strategies, transaction gateway operations, public-address portfolios, security checks, and audit logs.

Intent Routing

Match the user intent to a row, then **read that row's linked file first** — it holds the flow. Read only the matched file; do not load other rows' files. Each file links its own deeper files (cli-reference, troubleshooting) at the bottom via explicit links — open those when the flow needs them; never construct a file path yourself.

| User Intent | Reference | | --- | --- | | Sign in / connect / social login (Google / Apple / Email) / logout; add / switch account; login status | [wallet](references/wallet.md) | | Deposit / top up / receive a token; my receive address or QR code | [funding](references/funding.md) | | Check my (logged-in) balance / holdings, including BTC or a BRC-20 ticker | [wallet](references/wallet.md) | | Bitcoin UTXO-specific queries, management, or FAQ / definitions | [utxo-cli-reference](references/utxo-cli-reference.md) | | Send / transfer native, ERC-20, SPL, BTC, BRC-20, or SUI tokens | [wallet](references/wallet.md) | | Call a contract (approve / deposit / withdraw / custom function), including a SUI PTB | [wallet](references/wallet.md) | | Transaction history / tx detail / order status; sign a message (personalSign / EIP-712) | [wallet](references/wallet.md) | | Policy / spending limit / whitelist; export wallet / mnemonic; MEV protection for a contract-call; third-party Solana plugin write pre-flight | [wallet](references/wallet.md) | | Apple-login wallet differs from the OKX Wallet App / "missing" balance; rename a wallet or account; how transaction signing works (TEE) | [account-faq](references/account-faq.md) | | Pay gas with a stablecoin on Solana; enable / disable / change default gas token / status; a `send` / `contract-call` returns `gasStationUsed` or a Gas Station Confirming; Gas Station FAQ / "check order" | [gas-station](references/gas-station.md) | | Swap / trade / buy / sell / convert tokens; quote; best route; calldata-only swap; liquidity sources; ERC-20 approval for a DEX | [swap](references/swap.md) | | Bridge / cross-chain swap / move tokens between chains; bridge quote / fee comparison; supported bridges; track cross-chain arrival | [bridge](references/bridge.md) | | Limit order: buy dip / take profit / stop loss / buy above; cancel / list / resume limit (strategy) orders | [strategy](references/strategy.md) | | Broadcast a signed / raw tx; estimate gas price / gas-limit; simulate a tx; track a broadcast order | [gateway](references/gateway.md) | | A given public address's balance / holdings / total value (`0xAbc…` / a Solana address) | [portfolio](references/portfolio.md) | | Token / honeypot safety; DApp / URL phishing; tx or signature pre-check; check / list / revoke token approvals (ERC-20 / Permit2) | [security](references/security.md) | | Export / locate audit log, view command history | [audit-log](references/audit-log.md) |

---

Preflight

Preflight checks: At the start of each thread, complete the checks in [_shared/preflight.md](_shared/preflight.md).

Build the Command

1. **Read the matched row's linked file first** (per the Intent Routing table) — it carries the flow and the commands you need. Never guess subcommand, flag, or file names. 2. **Use the matched reference as the command contract.** Run CLI `--help` only when the matched reference does not provide the required syntax, the installed CLI rejects the documented command or flag, or version drift is suspected. Do not run `--help` routinely before a command whose syntax is already explicit and verified in the current thread. Load the matched domain's `-cli-reference.md` only when its return-field schema or examples are needed. 3. **Confirm before any state-changing command.** Display the prompt, get an explicit affirmative, and follow the Confirming Response rule below. For native BTC, direct BRC-20, and SUI transfers, follow the chain-specific confirmation flow; a BRC-20 transfer inscription confirms before signing and broadcast.

Chain Name Support

`--chain` accepts numeric chain IDs and human-readable names. Resolution rules and the supported-chain matrix live in [_shared/chain-support.md](_shared/chain-support.md). If <100% confident of a chain name, run `onchainos wallet chains`.

Confirming Response

Some state-changing commands return **confirming** (exit code **2**) when the backend needs user confirmation. The response carries `message` (prompt to show) and `next` (what to do after they confirm).

1. **Display** `message` and ask for confirmation. 2. **Confirms** → immediately follow `next` (usually: re-run the same command with `--force` appended). For `wallet send`, do not query `wallet balance` between confirmation and the re-run; the server validates balances and gas. 3. **Declines** → do NOT proceed; tell the user it was cancelled.

Never pass `--force` on the FIRST invocation of a state-changing command. Add `--force` only after all of: (1) you ran the command once without it, (2) the CLI returned a Confirming response (exit code 2, `"confirming": true`), (3) you displayed `message` and the user explicitly confirmed.

Amount Display Rules

• Token amounts in **UI units** (`1.5 ETH`), never base units.
• USD values with *