Okx Wallet Portfolio
Query and reason over OKX Onchain OS wallet balances and portfolio context across named chains using the shared CLI chain resolution.
Overview
OKX Wallet Portfolio is an agent skill for the Build phase that connects agents to OKX Onchain OS wallet and chain portfolio context with resolved chain names and Gas Station coverage.
Install
npx skills add https://github.com/okx/onchainos-skills --skill okx-wallet-portfolioWhat is this skill?
- Human-readable chain names auto-resolve to chainIndex for CLI calls
- Documents seven chains with wallet address creation: XLayer, XLayer Testnet, Solana, Ethereum, Base, BSC, Arbitrum
- Broader wallet interaction spans 17+ chains via onchainos wallet chains
- Gas Station matrix for 11 EVM chains with native symbols and USDT/USDC/USDG acceptance
- Shared chain-name support reused across onchainos skills for consistent agent behavior
- 7 chains support wallet address creation
- 11 EVM chains in Gas Station matrix
- 17+ chains for wallet interaction beyond address-creation list
Adoption & trust: 7.1k installs on skills.sh; 284 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your agent guesses chain IDs and gas tokens instead of using OKX’s supported chain list and portfolio commands consistently.
Who is it for?
Builders adding multi-chain wallet views or gas-aware flows on OKX Onchain OS CLI skills.
Skip if: Token risk dashboards, holder cluster analysis, or WebSocket trading bots—use okx-dex-token or okx-dex-ws instead.
When should I use this skill?
User needs OKX wallet portfolio, chain listing, or gas token matrix while building on Onchain OS.
What do I get? / Deliverables
Agents call wallet portfolio flows with correct chainIndex mapping and authoritative Gas Station token support per chain.
- Correct chainIndex resolution for wallet calls
- Gas Station chain and stablecoin reference for agents
Recommended Skills
Journey fit
Wallet portfolio access is integration work you add while building crypto-aware agents or CLIs, not a launch or growth marketing task. Hooks the Onchain OS wallet surface (chainIndex resolution, multi-chain support) into your product—not frontend polish alone.
How it compares
Chain-and-portfolio reference layer for Onchain OS, not a full DEX analytics suite.
Common Questions / FAQ
Who is okx-wallet-portfolio for?
Solo developers building crypto agents or internal tools that read OKX wallet state across several L1/L2 chains.
When should I use okx-wallet-portfolio?
During Build integrations when you need portfolio or chain metadata before transfers, gas sponsorship, or cross-chain UI copy.
Is okx-wallet-portfolio safe to install?
Treat it as financial infrastructure: review Prism Security Audits on this page, limit API keys, and never expose signing keys to untrusted agent runs.
SKILL.md
READMESKILL.md - Okx Wallet Portfolio
# Shared Chain Name Support > This file is shared across all onchainos skills. The CLI accepts human-readable chain names and resolves them automatically. ## Wallet address creation (7 chains) The following 7 chains support **wallet address creation** (i.e., you can generate a wallet address on these chains): | Chain | Name | chainIndex | |---|---|---| | XLayer | `xlayer` | `196` | | XLayer Testnet | `xlayer_test` | `1952` | | Solana | `solana` | `501` | | Ethereum | `ethereum` | `1` | | Base | `base` | `8453` | | BSC | `bsc` | `56` | | Arbitrum | `arbitrum` | `42161` | > **Note**: The wallet supports interacting with 17+ chains beyond this list (e.g., Polygon, Avalanche, Optimism). > Run `onchainos wallet chains` for the full list of supported chains. ## Gas Station supported chains and tokens (11 EVM chains) Authoritative matrix for Gas Station. Use this when the Agent needs chain display names, native token symbols, or the set of stablecoins accepted on each chain. | chainIndex | Display name | Native symbol | USDT | USDC | USDG | |---|---|---|---|---|---| | `1` | Ethereum | ETH | ✓ | ✓ | ✓ | | `56` | BNB Chain | BNB | ✓ | ✓ | | | `8453` | Base | ETH | ✓ | ✓ | | | `42161` | Arbitrum One | ETH | ✓ | ✓ | | | `137` | Polygon | MATIC | ✓ | ✓ | | | `10` | Optimism | ETH | ✓ | ✓ | | | `1030` | Conflux eSpace | CFX | ✓ | ✓ | | | `59144` | Linea | ETH | ✓ | ✓ | | | `534352` | Scroll | ETH | ✓ | ✓ | | | `10143` | Monad | MON | ✓ | ✓ | | | `146` | Sonic EVM | S | | ✓ | | > **Always derive the per-tx token set from the Phase 1 response's `gasStationTokenList`** — it's backend-authoritative and already scoped to the current chain. The table above is for reference only (FAQ answers, chain-list questions, unsupported-chain detection). chainIndex values for Conflux / Monad / Sonic are included for completeness; verify against `onchainos wallet chains` before relying on them for dispatch. **Related rules** (see `references/gas-station.md`): - Gas Station only triggers on the 11 chains above; for any other chain the backend returns `gasStationUsed=false` and the default native-gas flow runs. - Per-chain setup is one-time and happens automatically inside the first Gas Station transaction on that chain. - Every Gas Station state (enable flag, default gas token) is scoped to `(account, chain)` — switching a chain doesn't affect others. # Shared Pre-flight Checks > This file is shared across all onchainos skills. Follow these steps before the first `onchainos` command each session. Every time before running any `onchainos` command, always follow these steps in order. Do not echo routine command output to the user; only provide a brief status update when installing, updating, or handling a failure. 1. **Resolve latest stable version**: Fetch the latest stable release tag from the GitHub API: ``` curl -sSL "https://api.github.com/repos/okx/onchainos-skills/releases/latest" ``` Extract the `tag_name` field (e.g., `v1.0.5`) into `LATEST_TAG`. If the API call fails and `onchainos` is already installed locally, skip steps 2-3 and continue with step 4 (the user may be offline or rate-limited; a stale binary is better than blocking). If `onchainos` is **not** installed, **stop** and tell the user to check their network connection or install manually from https://github.com/okx/onchainos-skills. 2. **Install or update**: If `onchainos` is not found, or if the cache at `~/.onchainos/last_check` (`$env:USERPROFILE\.onchainos\last_check` on Windows) is older than 12 hours: - Download the installer and its checksum file from the latest release tag: - **macOS/Linux**: `curl -sSL "https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh" -o /tmp/onchainos-install.sh` `curl -sSL "https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt" -o /tmp/installer-checksums.txt` - **Windows**: `Invoke-WebRequest -Uri "https://raw.gi