OKX DeFi Portfolio

2 commands for viewing DeFi positions and holdings across protocols and chains.

Skill Routing

• For DeFi deposit/redeem/claim → use okx-defi-invest

• For token price/chart → use okx-dex-market

• For wallet token balances → use okx-wallet-portfolio

• For DEX spot swap → use okx-dex-swap

Quickstart

# Get DeFi holdings overview across chains

onchainos defi positions \

  --address 0xYourWallet \

  --chains ethereum,bsc,solana

Get detailed holdings for a specific protocol (analysisPlatformId from positions output)

onchainos defi position-detail

--address 0xYourWallet

--chain ethereum

--platform-id 67890

## Command Index

| # | Command | Description |

|---|---------|-------------|

| 1 | `onchainos defi support-chains` | Get supported chains for DeFi |

| 2 | `onchainos defi support-platforms` | Get supported platforms for DeFi |

| 3 | `onchainos defi positions --address <addr> --chains <chains>` | Get user DeFi holdings overview |

| 4 | `onchainos defi position-detail --address <addr> --chain <chain> --platform-id <id>` | Get detailed holdings for a protocol |

## Chain Support

| Chain | Name / Aliases | chainIndex |

|-------|----------------|-----------|

| Ethereum | `ethereum`, `eth` | `1` |

| BSC | `bsc`, `bnb` | `56` |

| Polygon | `polygon`, `matic` | `137` |

| Arbitrum | `arbitrum`, `arb` | `42161` |

| Base | `base` | `8453` |

| X Layer | `xlayer`, `okb` | `196` |

| Avalanche | `avalanche`, `avax` | `43114` |

| Optimism | `optimism`, `op` | `10` |

| Fantom | `fantom`, `ftm` | `250` |

| Sui | `sui` | `784` |

| Tron | `tron`, `trx` | `195` |

| TON | `ton` | `607` |

| Linea | `linea` | `59144` |

| Scroll | `scroll` | `534352` |

| zkSync | `zksync` | `324` |

| Solana | `solana`, `sol` | `501` |

## Operation Flow

### Step 0: Address Resolution

When the user does NOT provide a wallet address, resolve it automatically from the Agentic Wallet **before** running any defi command:

• onchainos wallet status → check if logged in, get active account

• onchainos wallet addresses → get addresses grouped by chain category:
• XLayer addresses
• EVM addresses (Ethereum, BSC, Polygon, etc.)
• Solana addresses

• Match address to target chain:

• EVM chains → use EVM address

• Solana → use Solana address

• XLayer → use XLayer address

Rules:

- If the user provides an explicit address, use it directly — skip this step

- If wallet is not logged in, ask the user to log in first (→ `okx-agentic-wallet`) or provide an address manually

- If the user says "check all accounts" or "all wallets", use `wallet balance --all` to get all account IDs, then `wallet switch <id>` + `wallet addresses` for each account, and query positions for each

- Always confirm the resolved address with the user before proceeding if the account has multiple addresses of the same type

### Step 1: Identify Intent

| User says | Action |

|-----------|--------|

| View positions / portfolio / holdings | `onchainos defi positions` |

| View detail for a protocol | `onchainos defi position-detail` |

| Redeem / claim after viewing | Suggest → use `okx-defi-invest` |

### Step 2: Collect Parameters

- **Missing wallet address** → resolve via Step 0 (wallet status → wallet addresses), or ask user if not logged in

- **Missing chains** → ask user which chains to query, or suggest common ones (ethereum, bsc, solana)

- **Missing platform-id** → run `defi positions` first to get `analysisPlatformId`

### Step 3: Display Results

#### Displaying Positions Results

When displaying `defi positions` output, you MUST use **exactly** these columns in this order — no substitutions, no omissions:

| # | Platform | analysisPlatformId | Chains | Positions | Value(USD) |

|---|---------|--------------------|----|--------|-----------|

| 1 | Aave V3 | 12345 | ETH,BSC | 2 | $120.00 |

Rules:

- **`analysisPlatformId` is MANDATORY in every row** — users must copy this value to run `position-detail`

- **Never omit, hide, or replace `analysisPlatformId`** with any other field

- **Never group platforms** — show every platform as its own row regardless of value size

- Raw JSON path: `walletIdPlatformList[*].platformList[*]` — each element is one platform row

  - `platformName` → Platform

  - `analysisPlatformId` → analysisPlatformId

  - `networkBalanceList[*].network` → Chains (join with comma)

  - `investmentCount` → Positions

  - `currencyAmount` → Value(USD)

#### Displaying Position Detail Results

**Output shape**: `{ "ok": true, "data": [ { "walletIdPlatformDetailList": [...] }, ... ] }` — `data` is an **array**. Never call `.get()` on `data` directly; iterate over it as a list.

When displaying `defi position-detail` output, render all tokens in a **single flat table** with these exact columns:

| Type | Asset | Amount | Value(USD) | investmentId | aggregateProductId | Token Contract | Rewards |

|------|------|------|-----------|--------------|--------------------|-----------|------|

| Supply | USDT | 1.002285 | $1.0025 | 127 | 71931 | 0x970223...7 | 0.000080 AVAX |

| Pending | sAVAX | 0.00000091 | $0.000012 | – | – | – | Platform reward |

Rules:

- Each token row is one row; merge in `investmentId` and `aggregateProductId` from its parent investment entry

- **`investmentId` is MANDATORY in every row** — users need it for `redeem`/`claim` (via `okx-defi-invest`)

- `aggregateProductId` — show if present, otherwise `–`

- Token Contract: show the **full contract address** without truncation; show `–` if native/empty

- Rewards: show pending reward amount + symbol if present, `–` if none; for platform rewards show `Platform reward`

- Type: map investType → Supply/Borrow/Stake/Farm/Pool etc; pending rewards row uses `Pending`

- **Health rate**: show separately below the table with warning if `healthRate < 1.5`

#### V3 Pool Positions — Extra Fields

For V3 Pool positions (`positionList` present), show an additional section per position:

| tokenId | Status | Range | tickLower | tickUpper |

|---------|--------|-------|-----------|-----------|

| 93828 | ACTIVE | 0.892 – 0.992 USDC/DAI | -33500 | -30450 |

- `tokenId`: from `positionList[].tokenId`

- `positionStatus`: `ACTIVE` or `INACTIVE`

- `range`: from `positionList[].range`

- `tickLower` / `tickUpper`: from `positionList[].rangeInfo.tickLower` / `rangeInfo.tickUpper`

- These fields are critical for V3 operations (add liquidity, withdraw, collect V3 fees)

## investType Reference

| investType | Description |

|------------|-------------|

| 1 | Save (savings/yield) |

| 2 | Pool (liquidity pool) |

| 3 | Farm (yield farming) |

| 4 | Vaults |

| 5 | Stake |

| 6 | Borrow |

| 7 | Staking |

| 8 | Locked |

| 9 | Deposit |

| 10 | Vesting |

## Post-execution Suggestions

| Just completed | Suggest |

|----------------|---------|

| `defi positions` | 1. View detail → `defi position-detail`  2. Redeem → `okx-defi-invest`  3. Claim rewards → `okx-defi-invest` |

| `defi position-detail` | 1. Redeem position → use `okx-defi-invest` with `investmentId` from table  2. Claim rewards → use `okx-defi-invest`  3. Add more → use `okx-defi-invest` |

| `defi position-detail` (V3 Pool) | 1. View depth chart → `defi depth-price-chart --investment-id <id>` (via `okx-defi-invest`)  2. View price history → `defi depth-price-chart --investment-id <id> --chart-type PRICE` |

## Global Notes

- **CRITICAL — Address-chain compatibility**: The `--address` and `--chains` parameters must be compatible. EVM addresses (`0x…`) can only query EVM chains; Solana addresses (base58) can only query `solana`. Never mix them in a single call — the API will return error 84019 (Address format error).

  - `0x…` address → only pass EVM chains: `ethereum,bsc,polygon,arbitrum,base,xlayer,avalanche,optimism,fantom,linea,scroll,zksync`

  - base58 address → only pass `solana`

  - Sui address → only pass `sui`

  - Tron address (`T…`) → only pass `tron`

  - TON address → only pass `ton`

  - If the user wants positions across both EVM and Solana, make **two separate calls** with the respective addresses

- `defi positions` uses `--chains` (plural, comma-separated, e.g. `--chains ethereum,bsc`) — do NOT use `--chain`

- `defi position-detail` uses `--chain` (singular) — do NOT use `--chains`

- The wallet address parameter is `--address` for both commands

- `position-detail` requires `analysisPlatformId` from `positions` output as `--platform-id`

- The CLI resolves chain names automatically (`ethereum` → `1`, `bsc` → `56`, `solana` → `501`)