Transaction List by wallet#
Retrieve transaction history for all or a specific chain under a wallet, sorted in descending order by time.
Request Path#
GET https://www.okx.com/api/waas/wallet/post-transaction/transactions
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| accountId | String | Yes | Unique account identifier |
| chainIndex | String | No | Unique chain identifier (optional, used to filter transactions for a specific chain) |
| tokenAddress | String | No | If not provided, query all transactions for the specified chain. Use "" for mainnet coin transactions and value for token-related transactions |
| limit | String | No | Number of transactions to retrieve per query, default is 50, maximum is 100 |
| cursor | String | No | Cursor position, defaults to the first transaction |
| begin | String | No | Start time, query transactions after this time. Unix timestamp in milliseconds |
| end | String | No | End time, query transactions before this time. If neither begin nor end is provided, query transactions before the current time. Unix timestamp in milliseconds |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| cursor | String | Cursor position |
| transactions | Array | List of transactions |
| >chainIndex | String | Unique chain identifier |
| >orderId | String | Unique transaction identifier |
| >txHash | String | Transaction hash |
| >fromAddr | String | Source address |
| >toAddr | String | Destination address |
| txType | String | Transaction type (transfer):1: Receive tokens 2: Send tokens 3: Contract interaction 4: Authorization 50: BRC20_MINT 51: BRC20_INSCRIBE 52: BRC20_TRADE 53: BRC20_SEND 54: BRC20_RECEIVE 60: BRC20_DEPLOY |
| >txTime | String | Transaction time in timestamp |
| >txStatus | String | Transaction status:1: Pending 2: Successful 3: Failed |
| >assetSummary | Array | Transaction summary |
| >>direction | String | Token amount change:1: Decrease 2: Increase |
| >>tokenAmount | String | Transaction currency amount |
| >>tokenAmountNum | String | Transaction token integer = transaction token amount * (10 ^ precision) |
| >>precision | String | Precision |
| >>tokenSymbol | String | Token symbol |
| >>tokenName | String | Token name |
| >>tokenLogoUrl | String | Token logo image URL (oss) |
| >>tokenAddress | String | Token address. Returns empty for mainnet coins. |
Request Example#
shell
curl --location --request GET 'https://www.okx.com/api/v5/waas/wallet/post-transaction/transactions?accountId=44486e05-3235-2f8e-5fe2-a8ab46217863&chains=111,333&chainIndex=1&tokenAddress=xxx&cursor=1&limit=20&begin=168000021888"&end=168000031888 \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--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' \
Response Example#
200
{
"code": "0",
"data": [
{
"chainIndex": "3",
"orderId": "string",
"txHash": "0xcbf411766d65f3cf92839ababa73c4afec69a83442e8b67a68b5104b50a04ejb",
"fromAddr": "0x5ffe4eabaf030jg7a1a75d309ead7ad31a0ef980",
"toAddr": "0x5ffe4eabaf03ff67a1a75d309ead7ad31a0ef817",
"txType": "2",
"txTime": "0",
"txStatus": "1",
"assetSummary": [{
"tokenAmount": "5.5",
"tokenAmountNum": "5",
"direction":"1",
"precision": "8",
"tokenSymbol": "ETH",
"tokenName": "Ethereum",
"tokenLogoUrl": "http://example.com/token.png",
"tokenAddress": ""
}]
}
],
"msg": "success"
}