request(
  'GET',
  '/v1/custody/transactions_by_time_ex/',
  {
    "coins": "COBO_HNS",
    "side": 2,
    "status": 900,
    "begin_time": 1699249938000,
    "limit": 10,
    "offset": 0,
    "order": "DESC",
  },
  api_key, api_secret, host
)

{
  "success": true,
  "result": [
    {
        "id": "20231229164409000331925000008218",
        "coin": "COBO_HNS",
        "display_code": "COBO_HNS",
        "description": "",
        "decimal": 6,
        "address": "rs1qsppf0ypx5lmjepc5s55rqwdlefk9n2saglxzm6",
        "source_address": "rs1qt8f7pjuc6de5ljgtm96l2gkl4x7pq497j8qdn3",
        "side": "withdraw",
        "amount": "500",
        "abs_amount": "0.0005",
        "txid": "7d4c49b653633f65cff08932bab41e2fe594b3d90c7f1978d9e4a0eb678b7468",
        "vout_n": 0,
        "request_id": "IntegrationTest-854963652255465838",
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1703839219000,
        "last_time": 1703839450000,
        "confirmed_num": 2,
        "remark": "",
        "tx_detail": {
            "txid": "7d4c49b653633f65cff08932bab41e2fe594b3d90c7f1978d9e4a0eb678b7468",
            "blocknum": 1199326,
            "blockhash": "7cc460715566bd2fe2a545902ec8a52ac6ae79f28331bf58d6e07256bbb550ca",
            "fee": 0,
            "actualgas": 250000,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "rs1qt8f7pjuc6de5ljgtm96l2gkl4x7pq497j8qdn3",
        "memo": "",
        "confirming_threshold": 2,
        "fee_coin": "COBO_HNS",
        "fee_amount": 550000,
        "fee_decimal": 6,
        "type": "external"
    },
    {
        "id": "20231229161638000343969000005740",
        "coin": "COBO_HNS",
        "display_code": "COBO_HNS",
        "description": "",
        "decimal": 6,
        "address": "rs1qsppf0ypx5lmjepc5s55rqwdlefk9n2saglxzm6",
        "source_address": "rs1q5gqkxzd6g02csmv9m22450p6hw5sqmrptuanjy",
        "side": "withdraw",
        "amount": "500",
        "abs_amount": "0.0005",
        "txid": "26316634afed164e24418bf2e01daf0466407ddf14de2b928a369b5184e1fba1",
        "vout_n": 0,
        "request_id": "IntegrationTest-854957104955502882",
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1703837659000,
        "last_time": 1703837798000,
        "confirmed_num": 2,
        "remark": "",
        "tx_detail": {
            "txid": "26316634afed164e24418bf2e01daf0466407ddf14de2b928a369b5184e1fba1",
            "blocknum": 1199299,
            "blockhash": "1a280b2d298ed217c8a4f9dbe42ae93e70c286bbe25350d9d70009a66779deb1",
            "fee": 0,
            "actualgas": 250000,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "rs1q5gqkxzd6g02csmv9m22450p6hw5sqmrptuanjy",
        "memo": "",
        "confirming_threshold": 2,
        "fee_coin": "COBO_HNS",
        "fee_amount": 550000,
        "fee_decimal": 6,
        "type": "external"
    }
  ]
}

Transactions

Get Transactions By time and offset

This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.

This endpoint returns a list of transactions filtered by time range, transaction status, coins, transaction side (deposit/withdraw) and address. As the extension of Get Transactions By Time, this endpoint introduced a new ‘offset’ parameter used for performing pagination query of transactions. The response includes transaction details such as transaction hash, amount, and timestamp.

GET

https://api.dev.cobo.com

custody

transactions_by_time_ex

request(
  'GET',
  '/v1/custody/transactions_by_time_ex/',
  {
    "coins": "COBO_HNS",
    "side": 2,
    "status": 900,
    "begin_time": 1699249938000,
    "limit": 10,
    "offset": 0,
    "order": "DESC",
  },
  api_key, api_secret, host
)

{
  "success": true,
  "result": [
    {
        "id": "20231229164409000331925000008218",
        "coin": "COBO_HNS",
        "display_code": "COBO_HNS",
        "description": "",
        "decimal": 6,
        "address": "rs1qsppf0ypx5lmjepc5s55rqwdlefk9n2saglxzm6",
        "source_address": "rs1qt8f7pjuc6de5ljgtm96l2gkl4x7pq497j8qdn3",
        "side": "withdraw",
        "amount": "500",
        "abs_amount": "0.0005",
        "txid": "7d4c49b653633f65cff08932bab41e2fe594b3d90c7f1978d9e4a0eb678b7468",
        "vout_n": 0,
        "request_id": "IntegrationTest-854963652255465838",
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1703839219000,
        "last_time": 1703839450000,
        "confirmed_num": 2,
        "remark": "",
        "tx_detail": {
            "txid": "7d4c49b653633f65cff08932bab41e2fe594b3d90c7f1978d9e4a0eb678b7468",
            "blocknum": 1199326,
            "blockhash": "7cc460715566bd2fe2a545902ec8a52ac6ae79f28331bf58d6e07256bbb550ca",
            "fee": 0,
            "actualgas": 250000,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "rs1qt8f7pjuc6de5ljgtm96l2gkl4x7pq497j8qdn3",
        "memo": "",
        "confirming_threshold": 2,
        "fee_coin": "COBO_HNS",
        "fee_amount": 550000,
        "fee_decimal": 6,
        "type": "external"
    },
    {
        "id": "20231229161638000343969000005740",
        "coin": "COBO_HNS",
        "display_code": "COBO_HNS",
        "description": "",
        "decimal": 6,
        "address": "rs1qsppf0ypx5lmjepc5s55rqwdlefk9n2saglxzm6",
        "source_address": "rs1q5gqkxzd6g02csmv9m22450p6hw5sqmrptuanjy",
        "side": "withdraw",
        "amount": "500",
        "abs_amount": "0.0005",
        "txid": "26316634afed164e24418bf2e01daf0466407ddf14de2b928a369b5184e1fba1",
        "vout_n": 0,
        "request_id": "IntegrationTest-854957104955502882",
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1703837659000,
        "last_time": 1703837798000,
        "confirmed_num": 2,
        "remark": "",
        "tx_detail": {
            "txid": "26316634afed164e24418bf2e01daf0466407ddf14de2b928a369b5184e1fba1",
            "blocknum": 1199299,
            "blockhash": "1a280b2d298ed217c8a4f9dbe42ae93e70c286bbe25350d9d70009a66779deb1",
            "fee": 0,
            "actualgas": 250000,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "rs1q5gqkxzd6g02csmv9m22450p6hw5sqmrptuanjy",
        "memo": "",
        "confirming_threshold": 2,
        "fee_coin": "COBO_HNS",
        "fee_amount": 550000,
        "fee_decimal": 6,
        "type": "external"
    }
  ]
}

Request

coins

String

Coin codes. Separated by commas

side

Int

1: TRANSACTION_DEPOSIT; 2: TRANSACTION_WITHDRAW

status

Int

Status Type	Code
PENDING_APPROVAL	101
SENT	201
PENDING_CONFIRMATION	501
SUCCESS	900
FAILED	901

address

String

Deposit address

begin_time

Long

Begin timestamp(milliseconds). If set, transactions whose transaction created time is greater than or equal to this will be returned.

end_time

Long

End timestamp (milliseconds). If set, the transactions whose created time is less than this will be returned.

limit

Integer

Page size. If not set, the default size will be 50, and the maximum size will also be 50.

offset

Integer

Offset specifies the starting index for the current query, indicating the number of transactions to skip before fetching and returning the transactions in the result.

order_by

String

Sorting method. Default: created_time; other option: last_time

order

String

Sorting order. Options: ASC (default), DESC

txid

String

Transaction ID

Response

success

bool

request successful or failed

result

object[]

Show object

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

Show 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/transactions_by_time_ex/',
  {
    "coins": "COBO_HNS",
    "side": 2,
    "status": 900,
    "begin_time": 1699249938000,
    "limit": 10,
    "offset": 0,
    "order": "DESC",
  },
  api_key, api_secret, host
)

{
  "success": true,
  "result": [
    {
        "id": "20231229164409000331925000008218",
        "coin": "COBO_HNS",
        "display_code": "COBO_HNS",
        "description": "",
        "decimal": 6,
        "address": "rs1qsppf0ypx5lmjepc5s55rqwdlefk9n2saglxzm6",
        "source_address": "rs1qt8f7pjuc6de5ljgtm96l2gkl4x7pq497j8qdn3",
        "side": "withdraw",
        "amount": "500",
        "abs_amount": "0.0005",
        "txid": "7d4c49b653633f65cff08932bab41e2fe594b3d90c7f1978d9e4a0eb678b7468",
        "vout_n": 0,
        "request_id": "IntegrationTest-854963652255465838",
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1703839219000,
        "last_time": 1703839450000,
        "confirmed_num": 2,
        "remark": "",
        "tx_detail": {
            "txid": "7d4c49b653633f65cff08932bab41e2fe594b3d90c7f1978d9e4a0eb678b7468",
            "blocknum": 1199326,
            "blockhash": "7cc460715566bd2fe2a545902ec8a52ac6ae79f28331bf58d6e07256bbb550ca",
            "fee": 0,
            "actualgas": 250000,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "rs1qt8f7pjuc6de5ljgtm96l2gkl4x7pq497j8qdn3",
        "memo": "",
        "confirming_threshold": 2,
        "fee_coin": "COBO_HNS",
        "fee_amount": 550000,
        "fee_decimal": 6,
        "type": "external"
    },
    {
        "id": "20231229161638000343969000005740",
        "coin": "COBO_HNS",
        "display_code": "COBO_HNS",
        "description": "",
        "decimal": 6,
        "address": "rs1qsppf0ypx5lmjepc5s55rqwdlefk9n2saglxzm6",
        "source_address": "rs1q5gqkxzd6g02csmv9m22450p6hw5sqmrptuanjy",
        "side": "withdraw",
        "amount": "500",
        "abs_amount": "0.0005",
        "txid": "26316634afed164e24418bf2e01daf0466407ddf14de2b928a369b5184e1fba1",
        "vout_n": 0,
        "request_id": "IntegrationTest-854957104955502882",
        "status": "success",
        "abs_cobo_fee": "0",
        "created_time": 1703837659000,
        "last_time": 1703837798000,
        "confirmed_num": 2,
        "remark": "",
        "tx_detail": {
            "txid": "26316634afed164e24418bf2e01daf0466407ddf14de2b928a369b5184e1fba1",
            "blocknum": 1199299,
            "blockhash": "1a280b2d298ed217c8a4f9dbe42ae93e70c286bbe25350d9d70009a66779deb1",
            "fee": 0,
            "actualgas": 250000,
            "gasprice": 1,
            "hexstr": ""
        },
        "source_address_detail": "rs1q5gqkxzd6g02csmv9m22450p6hw5sqmrptuanjy",
        "memo": "",
        "confirming_threshold": 2,
        "fee_coin": "COBO_HNS",
        "fee_amount": 550000,
        "fee_decimal": 6,
        "type": "external"
    }
  ]
}

Feel free to share your feedback to improve our documentation!

Get Transactions By Time Pending transaction

⌘I

Overview

Custodial Wallets API

MPC Wallets API

Development

Get Transactions By time and offset

Request

Response

Overview

Custodial Wallets API

MPC Wallets API

Development

​Request

​Response

Request

Response