okx-defi-portfolio

仓库: okx/onchainos-skills
安装量: 3.1K
排名: #1884

安装

npx skills add https://github.com/okx/onchainos-skills --skill okx-defi-portfolio

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 --chains Get user DeFi holdings overview 4 onchainos defi position-detail --address --chain --platform-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: 1. onchainos wallet status → check if logged in, get active account 2. onchainos wallet addresses → get addresses grouped by chain category: - XLayer addresses - EVM addresses (Ethereum, BSC, Polygon, etc.) - Solana addresses 3. 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 + 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
(via
okx-defi-invest
) 2. View price history →
defi depth-price-chart --investment-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 )
← 返回排行榜