按 txhash 查交易详情#

根据 txHash 查询某个交易的详情。支持根据子交易类型 iType 以及索引值 logIndex 查询。

OKX WaaS将一笔交易和其中的内部交易都分解成子交易，并根据变动的资产类型给出了不同的子交易类型： 0:外层主链币转移、 1:合约内层主链币转移、 2:token转移

请求路径#

GET https://www.okx.com/api/waas/wallet/post-transaction/transaction-detail-by-txhash

请求参数#

Parameter	Type	Required	Description
chainIndex	String	Yes	链唯一标识
txHash	String	Yes	交易哈希
iType	String	No	子交易类型： `0`: 外层主链币转移 `1`: 内层主链币转移 `2`: token转移
logIndex	String	No	索引值。订阅webhook后，推送交易历史时会给子交易附上logIndex

响应参数#

Parameter	Type	Description
chainIndex	String	链唯一标识
orderId	String	订单唯一标识
blockHash	String	区块哈希
blockHeight	String	区块高度
blockTime	String	区块时间
txHash	String	交易哈希
feeUsdValue	String	手续费，以美元计价。pending 时展示的是预估数量，上链后更新成实际花费数量
fees	String	手续费，EVM 交易单位为 wei，UTXO 交易单位为 sats。pending 时展示的是预估数量，上链后更新成实际花费数量
gasLimt	String	gas limit，不适用于 UTXO
gasPrice	String	gas price，单位为 wei，不适用于 UTXO
gasUsed	String	已使用 gaslimit 的数量，不适用于 UTXO
txTime	String	交易时间，时间戳格式
txType	String	交易类型(transfer): `1`: 接收代币 `2`: 发送代币 `3`: 合约交互 `4`: 授权 `50`：BRC20_MINT `51`：BRC20_INSCRIBE `52`：BRC20_TRADE `53`：BRC20_SEND `54`：BRC20_RECEIVE `60`：BRC20_DEPLOY
txStatus	String	交易状态: 1:排队中 2:成功 3:失败
evmDetails	Array	EVM链子交易详情
>fromAddr	String	来源地址
>toAddr	String	目的地址
>txAmount	String	转账主链币数量
>iType	String	子交易类型: `0`: 外层主链币转移 `1`: 内层主链币转移 `2`: token转移
>tokenAddress	String	合约地址
>contractCall	Boolean	合约调用
>logIndex	String	日志索引
>nonce	String	nonce
>status	String	子交易状态: `1`: 排队中 `2`: 成功 `3`: 失败
utxoDetail	Object	UTXO 子交易详情
>vin	Array	输入
>>addr	String	地址
>>number	String	序号
>>txHash	String	交易哈希
>>amount	String	数量
>>voutIndex	String	输出
>voutIndex	Array	输出
>>addr	String	地址
>>addrInVin	Boolean	这个输出地址是否同时也在vin里
>>number	String	序号
>>amount	String	数量

请求示例#

shell

curl --location --request GET 'https://www.okx.com/api/v5/waas/wallet/post-transaction/transaction-detail-by-txhash?txHash=0x3jjdx99hkljbxk138791001&chainIndex=111&iType=0&index=1' \
--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'

响应示例#

200

以 ETH 为例

{
    "code": "0",
    "data":[ 
        {
            "chainIndex": "0",  
            "orderId": "String", 
            "txHash": "String", 
            "blockHash" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",
            "blockHeight" : "19235519",
            "blockTime" : "1708026551000",
            "txHash": "String", 
            "feeUsdValue" : "138.846919",
            "fees" : "49102595635945621",
            "gasLimit" : "2000000",
            "gasPrice" : "87504603347",
            "gasUsed" : "561143",
            "txType": "0",  
            "txTime": "0", 
            "txStatus": "0",
            "evmDetails": [
               {
                  "iType" : "0",  
                  "txAmount": "0",
                  "tokenAddress":""
                  "contractCall" : true,
                  "fromAddr" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",
                  "toAddr" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",
                  "logIndex" : "-1",
                  "status" : "SUCCESS"
               }
             ] 
       }
     ],
    "msg": "success"
}

以 BTC 为例

{
    "code": "0",
    "data":[ 
        {
            "chainIndex": "0",  
            "orderId": "String", 
            "txHash": "String", 
            "blockHash" : "0x3ee63382b883fc40e35da6023fb341dd01cd2ec011f992bb54cf312f517740c9",
            "blockHeight" : "19235519",
            "blockTime" : "1708026551000",
            "txHash": "String", 
            "feeUsdValue" : "138.846919",
            "fees" : "49102595635945621",
            "gasLimit" : "2000000",
            "gasPrice" : "87504603347",
            "gasUsed" : "561143",
            "txType": "0",  
            "txTime": "0", 
            "txStatus": "0",
            "utxoDetail":{
                "vin" : [
                    {
                      "addr" : "bc1p077evnzjv9w697a523jxvhyyt0aptmgunkk2a8wsppy3mty7gj7q9j6azc",
                      "number" : "0",
                      "txHash" : "3aead5cb471bf2d30b6c2bc9961a579a91ad0a7562800356e6c29f9c5b05a964",
                      "amount" : "2990241",
                      "voutIndex" : "1"
                    }
                ],
                "voutIndex" : [
                    {
                      "addr":"",
                      "addrInVin" : false,
                      "number" : "0",
                      "amount" : "0"
                    },
                    {
                      "addr" : "bc1p6eu0hkl3jy449wrm52exssure7a8083dcsfkydh02c4vyrs2y83shdcmsy",
                      "addrInVin" : false,
                      "number" : "1",
                      "amount" : "330"
                    }
                ]
            }
       }
    ],
    "msg": "success"
}