获取地址的历史 DEX 交易#
以时间倒序返回地址的历史 DEX 交易列表
限制：1000 条，单次请求最多 100 条
请求路径#
GET https://web3.okx.com/api/v6/dex/market/portfolio/dex-history
请求参数 / Request Parameters#
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chainIndex | String | 是 | 链的唯一标识，传入链的 ID（如 501: Solana） |
| walletAddress | String | 是 | 查询的钱包地址 |
| begin | String | 是 | 开始时间戳（毫秒） |
| end | String | 是 | 结束时间戳（毫秒） |
| tokenContractAddress | String | 否 | 代币合约地址，不传则返回所有代币的交易 |
| type | String | 否 | 交易类型，1=BUY，2=SELL，3=Transfer In，4=Transfer Out，支持逗号分隔多个类型 |
| cursor | String | 否 | 分页游标，传入上一次请求返回的 cursor 值 |
| limit | String | 否 | 每页返回数量，最大 100 |
响应参数 / Response Parameters#
| 参数 | 类型 | 说明 |
|---|---|---|
| transactionList | Array | 交易列表 |
| >type | String | 交易类型（1=BUY，2=SELL，3=Transfer In，4=Transfer Out） |
| >chainIndex | String | 链的唯一标识 |
| >tokenContractAddress | String | 代币合约地址 |
| >tokenSymbol | String | 代币符号 |
| >valueUsd | String | 交易金额（USD） |
| >amount | String | 代币数量 |
| >price | String | 交易价格 |
| >marketCap | String | 市值 |
| >pnlUsd | String | 收益（USD） |
| >time | String | 交易时间戳（毫秒） |
| cursor | String | 分页游标，用于获取下一页数据 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/portfolio/dex-history?chainIndex=1&walletAddress=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&begin=1700000000000&end=1710000000000&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": {
"transactionList": [
{
"type": "1",
"chainIndex": "1",
"tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"tokenSymbol": "USDT",
"valueUsd": "1000.00",
"amount": "1000",
"price": "1.00",
"marketCap": "100000000000",
"pnlUsd": "50.00",
"time": "1709900000000"
}
],
"cursor": "0"
},
"msg": ""
}