Get deposit history - DexBuilder Docs

GET

api

dexbuilder

deposit

history

Get deposit history

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/dexbuilder/deposit/history \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>'

import requests

url = "https://api.dexbuilder.com/api/v4/dexbuilder/deposit/history"

headers = {
    "X-User-Wallet-Address": "<x-user-wallet-address>",
    "KEY": "<api-key>",
    "Timestamp": "<api-key>",
    "SIGN": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "items": [
      {
        "tx_hash": "<string>",
        "status": 123,
        "amount": "<string>",
        "network": "<string>",
        "asset": "<string>"
      }
    ],
    "page": 123,
    "page_size": 123,
    "total": 123
  }
}

List a user’s deposit records.

Use a Broker API Key and pass the target user’s wallet in X-User-Wallet-Address. The gateway checks that the wallet belongs to your Broker. See Broker API Key and signing.

Usage notes

Current history records do not contain creation or update timestamps. Record the submission time in your own system if you need a timeline.

Authorizations

KEY

string

header

required

Broker API Key

Timestamp

string

header

required

Unix timestamp in seconds

SIGN

string

header

required

Hexadecimal HMAC-SHA512 signature generated with the Broker Secret Key

Headers

X-User-Wallet-Address

string

required

Target user's wallet address. The gateway verifies that the user belongs to the current Broker.

Query Parameters

page

integer

default:1

Page number, starting at 1

Required range: x >= 1

page_size

integer

default:20

Number of records per page, maximum 100

Required range: 1 <= x <= 100

Response

Query successful

code

integer

Business code; 0 indicates success

Example:

0

message

string

Human-readable message; success responses use success

Example:

"success"

reason

string

Error reason identifier; usually empty on success

trace_id

string

Trace ID to provide when requesting support

data

object

Show child attributes

Get deposit history

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/dexbuilder/deposit/history \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>'

import requests

url = "https://api.dexbuilder.com/api/v4/dexbuilder/deposit/history"

headers = {
    "X-User-Wallet-Address": "<x-user-wallet-address>",
    "KEY": "<api-key>",
    "Timestamp": "<api-key>",
    "SIGN": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "items": [
      {
        "tx_hash": "<string>",
        "status": 123,
        "amount": "<string>",
        "network": "<string>",
        "asset": "<string>"
      }
    ],
    "page": 123,
    "page_size": 123,
    "total": 123
  }
}

​Usage notes

Authorizations

Headers

Query Parameters

Response

Usage notes