request(
'GET',
'/v1/custody/transaction_history/',
{
"coin": "BTC_USDT",
"side": "deposit"
},
api_key, api_secret, host
)
coboFetch('GET', '/v1/custody/transaction_history/',
{
"coin": "BTC_USDT",
"side": "deposit"
},
api_key, api_secret, host
).then(res => {
res.json().then((data)=>{
console.log(JSON.stringify(data, null, 4));
})
}).catch(err => {
console.log(err)
});
Request("GET", "/v1/custody/transaction_history/", map[string]string{
"coin": "BTC_USDT",
"side": "deposit",
})
{
"success": true,
"result": [
{
"id": "20221013214833000312228000005846",
"coin": "BTC_USDT",
"display_code": "USDT",
"description": "Tether",
"decimal": 8,
"address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
"source_address": "AutoTest_RC02",
"side": "deposit",
"amount": "6000000",
"abs_amount": "0.06",
"txid": "L65954e38419b55abb10b37fc6fca54f",
"vout_n": 0,
"request_id": null,
"status": "success",
"abs_cobo_fee": "0",
"created_time": 1665668913144,
"last_time": 1665668913144,
"confirmed_num": 3,
"remark": "",
"tx_detail": {
"txid": "L65954e38419b55abb10b37fc6fca54f",
"blocknum": 0,
"blockhash": "",
"fee": 0,
"actualgas": 0,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "AutoTest_RC02",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_decimal": 8,
"fee_amount": 0,
"type": "internal",
"tx_request_type": ""
},
{
"id": "20221013213858000312228000007739",
"coin": "BTC_USDT",
"display_code": "USDT",
"description": "Tether",
"decimal": 8,
"address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
"source_address": "AutoTest_RC02",
"side": "deposit",
"amount": "23000000",
"abs_amount": "0.23",
"txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
"vout_n": 0,
"request_id": null,
"status": "success",
"abs_cobo_fee": "0",
"created_time": 1665668338625,
"last_time": 1665668338625,
"confirmed_num": 3,
"remark": "",
"tx_detail": {
"txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
"blocknum": 0,
"blockhash": "",
"fee": 0,
"actualgas": 0,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "AutoTest_RC02",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_decimal": 8,
"fee_amount": 0,
"type": "internal",
"tx_request_type": ""
}
]
}
Transactions
Transaction history
This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.
GET
/
v1
/
custody
/
transaction_history
/
request(
'GET',
'/v1/custody/transaction_history/',
{
"coin": "BTC_USDT",
"side": "deposit"
},
api_key, api_secret, host
)
coboFetch('GET', '/v1/custody/transaction_history/',
{
"coin": "BTC_USDT",
"side": "deposit"
},
api_key, api_secret, host
).then(res => {
res.json().then((data)=>{
console.log(JSON.stringify(data, null, 4));
})
}).catch(err => {
console.log(err)
});
Request("GET", "/v1/custody/transaction_history/", map[string]string{
"coin": "BTC_USDT",
"side": "deposit",
})
{
"success": true,
"result": [
{
"id": "20221013214833000312228000005846",
"coin": "BTC_USDT",
"display_code": "USDT",
"description": "Tether",
"decimal": 8,
"address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
"source_address": "AutoTest_RC02",
"side": "deposit",
"amount": "6000000",
"abs_amount": "0.06",
"txid": "L65954e38419b55abb10b37fc6fca54f",
"vout_n": 0,
"request_id": null,
"status": "success",
"abs_cobo_fee": "0",
"created_time": 1665668913144,
"last_time": 1665668913144,
"confirmed_num": 3,
"remark": "",
"tx_detail": {
"txid": "L65954e38419b55abb10b37fc6fca54f",
"blocknum": 0,
"blockhash": "",
"fee": 0,
"actualgas": 0,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "AutoTest_RC02",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_decimal": 8,
"fee_amount": 0,
"type": "internal",
"tx_request_type": ""
},
{
"id": "20221013213858000312228000007739",
"coin": "BTC_USDT",
"display_code": "USDT",
"description": "Tether",
"decimal": 8,
"address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
"source_address": "AutoTest_RC02",
"side": "deposit",
"amount": "23000000",
"abs_amount": "0.23",
"txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
"vout_n": 0,
"request_id": null,
"status": "success",
"abs_cobo_fee": "0",
"created_time": 1665668338625,
"last_time": 1665668338625,
"confirmed_num": 3,
"remark": "",
"tx_detail": {
"txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
"blocknum": 0,
"blockhash": "",
"fee": 0,
"actualgas": 0,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "AutoTest_RC02",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_decimal": 8,
"fee_amount": 0,
"type": "internal",
"tx_request_type": ""
}
]
}
Only successful deposit/withdraw requests will be considered as ‘Transaction’ here
Request
String
Coin code (Does not return all currencies)
enum(deposit / withdraw)
Deposit/withdraw
String
Deposit/withdraw address is optional. If not included, all address history will be returned.
String
The transaction history ID limit is optional. If not included, will by default return the most recent records.(cannot be used with min_id)
String
Optional. If included, the sequence will be changed to time ASC. If not included, will by default return the most recent records, time DESC.(cannot be used with max_id)
Integer
Page size is optional. If not included, the default size will be 50, and the maximum size will also be 50.
Long
Begin timestamp(milliseconds). If set, transactions whose confirmation times are shorter than this value will not be returned. (cannot be used with end_time)
Long
End time stamp (milliseconds). If it is passed in, the transactions whose transaction confirmation time is greater than or equal to this will not be returned.(cannot be used with begin_time)
String
Request all transactions, if they are, return all transactions (including Staking, Trading)
Response
bool
request successful or failed
object[]
Show object
Show object
String
Cobo Unique Transaction ID
String
Coin code (Cobo has internal symbols for each coin to ensure they are all unique)
String
Coin ticker symbol (not unique, changeable, for reference only)
String
Full name of coin (not unique, changeable, for reference only)
String
Deposit address
String
Memo for specified coins(EOS,XLM,XRP,IOST)
String
Source address
String
Separate by comma if more than one source address
enum(deposit / withdraw)
Transaction type
String
Transaction value (Note that the value here contains decimals. For example, a BTC value of 100,000,000 here is actually 1 BTC)
Int
Amount decimal
String
Transaction value (Note that this is an absolute value. If you trade 1.5 BTC, then the value is 1.5)
String
lute fee value. For examle, abs_cobo_fee 0.00005 means exactly 0.00005BTC
String
Transaction ID, which can be found on the corresponding public chain
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
String
Request ID
enum(success / failed / pending)
Transaction status. If using the 'pending_transaction' and 'pending_transaction' interfaces for querying, the status can only be 'pending'
Long
Withdraw request creation time
Long
Transaction creation time
Long
Transaction success/failure time
Int
Confirmed numbers required for a successful transaction
Int
Confirmed numbers
String
Transaction remark
object
String
Fee coin code
Int
Fee amount (Note that the value here contains decimals. For example, a BTC value of 100,000,000 here is actually 1 BTC)
Int
Fee decimal
String
external, internal shows if it's a Loop tx or external(on-chain)
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.
Int
| Transaction Request Type | Code |
|---|---|
| REQUEST_FROM_WEB | 100 |
| REQUEST_FROM_API | 200 |
| REQUEST_FROM_GAS_STATION | 1500 |
request(
'GET',
'/v1/custody/transaction_history/',
{
"coin": "BTC_USDT",
"side": "deposit"
},
api_key, api_secret, host
)
coboFetch('GET', '/v1/custody/transaction_history/',
{
"coin": "BTC_USDT",
"side": "deposit"
},
api_key, api_secret, host
).then(res => {
res.json().then((data)=>{
console.log(JSON.stringify(data, null, 4));
})
}).catch(err => {
console.log(err)
});
Request("GET", "/v1/custody/transaction_history/", map[string]string{
"coin": "BTC_USDT",
"side": "deposit",
})
{
"success": true,
"result": [
{
"id": "20221013214833000312228000005846",
"coin": "BTC_USDT",
"display_code": "USDT",
"description": "Tether",
"decimal": 8,
"address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
"source_address": "AutoTest_RC02",
"side": "deposit",
"amount": "6000000",
"abs_amount": "0.06",
"txid": "L65954e38419b55abb10b37fc6fca54f",
"vout_n": 0,
"request_id": null,
"status": "success",
"abs_cobo_fee": "0",
"created_time": 1665668913144,
"last_time": 1665668913144,
"confirmed_num": 3,
"remark": "",
"tx_detail": {
"txid": "L65954e38419b55abb10b37fc6fca54f",
"blocknum": 0,
"blockhash": "",
"fee": 0,
"actualgas": 0,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "AutoTest_RC02",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_decimal": 8,
"fee_amount": 0,
"type": "internal",
"tx_request_type": ""
},
{
"id": "20221013213858000312228000007739",
"coin": "BTC_USDT",
"display_code": "USDT",
"description": "Tether",
"decimal": 8,
"address": "38GewuNXgnbmsxgvGFKd5ZNjUdNavxgEGM",
"source_address": "AutoTest_RC02",
"side": "deposit",
"amount": "23000000",
"abs_amount": "0.23",
"txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
"vout_n": 0,
"request_id": null,
"status": "success",
"abs_cobo_fee": "0",
"created_time": 1665668338625,
"last_time": 1665668338625,
"confirmed_num": 3,
"remark": "",
"tx_detail": {
"txid": "L3dbb8e30d8da66c9ea0d7171e1fbe2c",
"blocknum": 0,
"blockhash": "",
"fee": 0,
"actualgas": 0,
"gasprice": 1,
"hexstr": ""
},
"source_address_detail": "AutoTest_RC02",
"confirming_threshold": 3,
"fee_coin": "BTC",
"fee_decimal": 8,
"fee_amount": 0,
"type": "internal",
"tx_request_type": ""
}
]
}
⌘I