获取地址的近期收益列表#
以时间倒序返回地址的最近收益列表
限制：1000条，单次请求最多100条
请求路径#
GET https://web3.okx.com/api/v6/dex/market/portfolio/recent-pnl
请求参数#
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chainIndex | String | 是 | 链的唯一标识，传入链的 ID（如 501: Solana），仅支持单链查询 |
| walletAddress | String | 是 | 查询的钱包地址 |
| cursor | String | 否 | 分页游标，传入上一次请求返回的 cursor 值 |
| limit | String | 否 | 每页返回数量，最大 100 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| cursor | String | 分页游标 |
| pnlList | Array | PnL 列表 |
| >chainIndex | String | 链的唯一标识 |
| >tokenContractAddress | String | 代币合约地址 |
| >tokenSymbol | String | 代币符号 |
| >lastActiveTimestamp | String | 最近活跃时间戳（毫秒） |
| >unrealizedPnlUsd | String | 未实现 PnL（USD），若该地址已全部卖出则返回 SELL_ALL |
| >unrealizedPnlPercent | String | 未实现 PnL 百分比 |
| >realizedPnlUsd | String | 已实现 PnL（USD） |
| >realizedPnlPercent | String | 已实现 PnL 百分比 |
| >totalPnlUsd | String | 总 PnL（USD） |
| >totalPnlPercent | String | 总 PnL 百分比 |
| >tokenBalanceUsd | String | 代币余额价值（USD） |
| >tokenBalanceAmount | String | 代币余额数量 |
| >tokenPositionPercent | String | 代币仓位占比 |
| >tokenPositionDuration | Object | 代币持仓时长信息 |
| >>holdingTimestamp | String | 持仓开始时间戳（毫秒） |
| >>sellOffTimestamp | String | 清仓时间戳（毫秒），若仍持有则为空 |
| >buyTxCount | String | 买入交易次数 |
| >buyTxVolume | String | 买入交易量 |
| >buyAvgPrice | String | 平均买入价格 |
| >sellTxCount | String | 卖出交易次数 |
| >sellTxVolume | String | 卖出交易量 |
| >sellAvgPrice | String | 平均卖出价格 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/portfolio/recent-pnl?chainIndex=1&walletAddress=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&limit=10' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
响应示例#
Json
{
"code": "0",
"data": {
"pnlList": [
{
"chainIndex": "1",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"tokenSymbol": "USDT",
"lastActiveTimestamp": "1710000000000",
"unrealizedPnlUsd": "100.00",
"unrealizedPnlPercent": "10.00",
"realizedPnlUsd": "200.00",
"realizedPnlPercent": "20.00",
"totalPnlUsd": "300.00",
"totalPnlPercent": "30.00",
"tokenBalanceUsd": "1000.00",
"tokenBalanceAmount": "1000",
"tokenPositionPercent": "10.00",
"tokenPositionDuration": {
"holdingTimestamp": "1700000000000",
"sellOffTimestamp": ""
},
"buyTxCount": "5",
"buyTxVolume": "900.00",
"buyAvgPrice": "0.99",
"sellTxCount": "2",
"sellTxVolume": "400.00",
"sellAvgPrice": "1.01"
}
]
},
"msg": ""
}