Transactions
Get Transaction Details
Account
Loop Alliance
Transactions
Withdraw
Staking
Trading
Gas Station
Account
Transaction
Withdraw
Tss Node
Bind Auth
Gas Station
Custodial Wallet APIs
MPC Wallet APIs
Transactions
Get Transaction Details
This endpoint retrieves a transaction by its ID from the WaaS API. The endpoint requires authentication and takes a single query parameter, ‘id’, which is the ID of the transaction to retrieve.
GET
/
v1
/
custody
/
transaction
/
API-SECRET
string
*
API-SECRET
Required
string
id
string
*
id
Required
string
Cobo Unique Transaction ID
request(
"GET" " /v1/custody/transaction/ ",
{
"id": "20210112173820000166329000003582",
},
api_key, api_secret, host
)
{
"success": true,
"result": {
"id": "20210112173820000166329000003582",
"coin": "BTC",
"display_code": "BTC",
"description": "Bitcoin",
"decimal": 8,
"address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku",
"source_address": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
"side": "withdraw",
"amount": "80000",
"abs_amount": "0.0008",
"txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
"vout_n": 0,
"request_id": "web_send_by_user_327_1610444045047",
"status": "success",
"abs_cobo_fee": "0",
"request_created_time": 1610444045158,
"created_time": 1610445878970,
"last_time": 1610445878970,
"confirmed_num": 3,
"remark":"hello test",
"tx_detail": {
"txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
"blocknum": 665711,
"blockhash": "00000000000000000007137dde44472364eb80126b7d98c12ffb8d37ba11ad33",
"fee": 0,
"actualgas": 17812,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
"memo": "",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_amount": 50000,
"fee_decimal": 8,
"type": "external",
"tx_request_type": ""
}
}
Only successful deposit/withdraw requests will be considered as ‘Transaction’ here
Request
id
String
requiredCobo Unique Transaction ID
Response
success
bool
request successful or failed
result
object
id
String
Cobo Unique Transaction ID
coin
String
Coin code (Cobo has internal symbols for each coin to ensure they are all unique)
display_code
String
Coin ticker symbol (not unique, changeable, for reference only)
description
String
Full name of coin (not unique, changeable, for reference only)
address
String
Deposit address
memo
String
Memo for specified coins(EOS,XLM,XRP,IOST)
source_address
String
Source address
source_address_detail
String
Separate by comma if more than one source address
side
enum(deposit / withdraw)
Transaction type
amount
String
Transaction value (Note that the value here contains decimals. For example, a BTC value of 100,000,000 here is actually 1 BTC)
decimal
Int
Amount decimal
abs_amount
String
Transaction value (Note that this is an absolute value. If you trade 1.5 BTC, then the value is 1.5)
abs_cobo_fee
String
lute fee value. For examle, abs_cobo_fee 0.00005 means exactly 0.00005BTC
txid
String
Transaction ID, which can be found on the corresponding public chain
vout_n
String
For transactions on public blockchains that allow for multiple deposit addresses in a single transaction, this value indicates the transaction index on the corresponding public blockchain
request_id
String
Request ID
status
enum(success / failed / pending)
Transaction status. If using the 'pending_transaction' and 'pending_transaction' interfaces for querying, the status can only be 'pending'
request_created_time
Long
Withdraw request creation time
created_time
Long
Transaction creation time
last_time
Long
Transaction success/failure time
confirming_threshold
Int
Confirmed numbers required for a successful transaction
confirmed_num
Int
Confirmed numbers
remark
String
Transaction remark
tx_detail
object
txid
string
transaction ID
blocknum
Int
block height
blockhash
string
block hash
fee
Int
tx fee
actualgas
Int
Actual Gas consumption, not denominated in Ethereum as a transaction fee.
gasprice
Int
Gas price, not denominated in Ethereum is 1
hexstr
Int
original transaction
fee_coin
String
Fee coin code
fee_amount
Int
Fee amount (Note that the value here contains decimals. For example, a BTC value of 100,000,000 here is actually 1 BTC)
fee_decimal
Int
Fee decimal
type
String
external, internal shows if it's a Loop tx or external(on-chain)
waiting_audit
Bool
When a transaction is in the pending state for deposit transactions and requires auditing, "waiting_audit" is set to true. For withdraw transactions, it always returns false.
tx_request_type
Int
Transaction Request Type | Code |
---|---|
REQUEST_FROM_WEB | 100 |
REQUEST_FROM_API | 200 |
REQUEST_FROM_GAS_STATION | 1500 |
request(
"GET" " /v1/custody/transaction/ ",
{
"id": "20210112173820000166329000003582",
},
api_key, api_secret, host
)
{
"success": true,
"result": {
"id": "20210112173820000166329000003582",
"coin": "BTC",
"display_code": "BTC",
"description": "Bitcoin",
"decimal": 8,
"address": "19AR6YWEGbSoY8UT9Ksy9WrmrZPD5sL4Ku",
"source_address": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
"side": "withdraw",
"amount": "80000",
"abs_amount": "0.0008",
"txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
"vout_n": 0,
"request_id": "web_send_by_user_327_1610444045047",
"status": "success",
"abs_cobo_fee": "0",
"request_created_time": 1610444045158,
"created_time": 1610445878970,
"last_time": 1610445878970,
"confirmed_num": 3,
"remark":"hello test",
"tx_detail": {
"txid": "239861be9a4afe080c359b7fe4a1d035945ec46256b1a0f44d1267c71de8ec28",
"blocknum": 665711,
"blockhash": "00000000000000000007137dde44472364eb80126b7d98c12ffb8d37ba11ad33",
"fee": 0,
"actualgas": 17812,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "bc1q0qfzuge7vr5s2xkczrjkccmxemlyyn8mhx298v",
"memo": "",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_amount": 50000,
"fee_decimal": 8,
"type": "external",
"tx_request_type": ""
}
}