Get Topup History

This interface is used to get the transaction list of a card in a specific date range. Date range is up to three months.

• Path: /api/v1/card/getTopupTransactionList

• Method: POST

• Content-Type

  application/json

• Headers

Key	Type	Required	Comments
authorization	string	YES	Authorization Header

• Body

Key	Type	Required	Comments
api_key	string	YES	api key
request_id	string	YES	Unique id; the shortest is 20 characters, the longest is 64 characters
timestamp	string	YES	13-digit; Valid for plus or minus 30 seconds
username	string	YES	Unique username of the account.
kit_number	string	YES	Show on card
top_up_method	number	NO	topup method；3Blockchain Direct、5FEB API topup
start_date	string	YES	This field is the start date for filtering transactions data.Format: YYYY-MM-DD.
end_date	string	YES	This field is the end date for filtering transactions data.Cannot be 3 months later than start_date.Format: YYYY-MM-DD.
sign	string	YES	sign: MD5(api_key+username+timestamp+secret+request_id)lowercase hex

• Example

  {
    api_key: 'ac97c403062e94a094131aa332df6458',
    request_id: '48d66a3ad67b4a3a8c4914a8b8927106',
    timestamp: '1722237748943',
    username: 'frfrfr',
    kit_number: '2000001785317853',
    top_up_method: 3,
    start_date: '2024-05-29',
    end_date: '2024-07-29',
    sign: '92526c65a3780d5d95afd6f278e52e72'
  }

  signature example:MD5(ac97c403062e94a094131aa332df6458frfrfr1722237748943a446b6660552582e08b043b84634e1fe48d66a3ad67b4a3a8c4914a8b8927106)

• Response

Key	Type	Comments
code	number	Response code
msg	string	Response message
data	object	details

details

Key	Type	Comments
list	array[object details]	Transaction list

object details

Key	Type	Comments
amount	string	topup amount
status	number	topup receive status. 1 success； 2 fail
token_type	string	token type USDT、USDC
card_status	number	topup card status 1 pending 2success 3fail
top_up_method	number	topup method；3Blockchain Direct、5FEB API topup
token_amount	string	token amount
time	number	FEB system entry time
transaction_id	string	Unique on-chain transaction id
transaction_hash	string	Unique on-chain transaction hash

• Example

  {
    "code": 10200,
    "msg": "ok",
    "data": {
      "list": [{
        "amount": "145.63",
        "status": 1,
        "token_type": "USDT",
        "card_status": 2,
        "top_up_method": 3,
        "token_amount": "150",
        "time": 1718425978468,
        "transaction_id": "2034497cffde4a28b27b971ef4895d60",
        "transaction_hash": "c9c900874643d79124f9b6216b033b4a20c680a0b363d9c17dc659bc0f8ddefe"
      },
      {
        "amount": "6.79",
        "status": 1,
        "token_type": "USDT",
        "card_status": 2,
        "top_up_method": 3,
        "token_amount": "7",
        "time": 1718426531736,
        "transaction_id": "a9eb7211e3404fa99f40902fbd9d5255",
        "transaction_hash": "14f5c987418d80df50047934fd7b8c7cb7893c907ff105842f2323ad911f4e6b"
      }]
    }
  }