Skip to main content

Primary Account APIs

Get Primary Account Details​

POST /abc/v1/account/detail

Retrieves the primary account's basic information, account status, and balances.

Request Headers​

X-API-Key
string
example
{apiKey}
X-Timestamp
integer
example
{{Timestamp}}
X-Nonce
string
example
{{Nonce}}
X-Signature
string
example
{{Signature}}
Content-Type
string
example
application/json

Request Body​

The file does not define a request body structure.

Successful Response​

Data model: CommonResultOpenAccountResponse

Response Fields​

code
integer
Description
Error code
msg
string
Description
Human-readable error message
message
string
View child fields
parentAccountId
string
Description
primary account unique ID
parentAccountName
string
Description
primary account name
accountStatus
integer
Description
Account status
Allowed values：
1active
2lost
3deleted
4dormant
availableAmount
number
Description
available balance, unit: cents
frozenAmount
number
Description
frozen balance, unit: cents
bookAmount
number
Description
book amount, unit: cents
currency
string
Description
Currency (ISO 4217), such as USD
createTime
string
Description
account opening time

Primary Account Management: Account Transfer​

POST /abc/v1/account/transfer

Transfers funds between the primary account and sub accounts, or between different sub accounts.

Request Headers​

X-API-Key
string
example
{apiKey}
X-Timestamp
integer
example
{{Timestamp}}
X-Nonce
string
example
{{Nonce}}
X-Signature
string
example
{{Signature}}
Content-Type
string
example
application/json

Request Body​

Data model: OpenAccountTransferRequest

transferInAccountId
string
Description
transfer-in account ID
transferInIsParentAccount
boolean
Description
whether the transfer-in account is the primary account
transferOutAccountId
string
Description
transfer-out account unique ID
transferOutIsParentAccount
boolean
Description
whether the transfer-out account is the primary account
transferAmount
number
Description
transfer amount

Successful Response​

Data model: CommonResultBoolean

Response Fields​

code
integer
Description
Error code
msg
string
Description
Human-readable error message
message
string
data
boolean
Description
Response data

Get Recharge Address​

POST /abc/v1/account/recharge-address

Retrieves the primary account's deposit address for subsequent funding operations.

Request Headers​

X-API-Key
string
example
{apiKey}
X-Timestamp
integer
example
{{Timestamp}}
X-Nonce
string
example
{{Nonce}}
X-Signature
string
example
{{Signature}}
Content-Type
string
example
application/json

Request Body​

The file does not define a request body structure.

Successful Response​

Data model: CommonResultOpenRechargeAddressResponse

Response Fields​

code
integer
Description
Error code
msg
string
Description
Human-readable error message
message
string
View child fields
address
string
Description
Merchant recharge address; null if the merchant has not enabled a wallet
minRechargeAmount
number
Description
Minimum recharge amount, unit: cents (minor unit); deposits below this amount are not credited

Query Primary Account Fund Flows​

POST /abc/v1/account/flow/query

Queries the primary account's fund movements by filter, with paginated results.

Request Headers​

X-API-Key
string
example
{apiKey}
X-Timestamp
integer
example
{{Timestamp}}
X-Nonce
string
example
{{Nonce}}
X-Signature
string
example
{{Signature}}
Content-Type
string
example
application/json

Request Body​

Data model: OpenAccountFlowQueryRequest

pageNo
integerRequired
Description
Page number, starting from 1
Range：≥1
Default：1
Example：1
pageSize
integerRequired
Description
Items per page, maximum 200
Range：≥1
Default：10
Example：10
accountFlowId
string
Description
Fund account transaction flow ID
Example / Default
2108839919989616642
parentAccountId
string
Description
primary account ID
Example / Default
210945783621084760203
currency
string
Description
currency code ISO 4217
Example / Default
USD
transTypes
arrayinteger>
Description
Transaction type array (pass one element when querying a single type)
Allowed values：
1self-service recharge
2outgoing transfer
3incoming transfer
4fee deduction
6manual recharge
7adjustment increase
8adjustment decrease
9refund
Items：1–8
rechargeMethod
integer
Description
Recharge method (only populated for recharge transactions)
Allowed values：
1USD transfer
5USDT transfer
6rebate-to-recharge
7balance transfer
8account adjustment
Example：5
transStatus
integer
Description
Transaction status
Allowed values：
1success
2failure
3pending
4processing
Range：1–4
Example：1
transactionTime
arraystring>
Description
Transaction time range: [start time, end time]
Items：2

Successful Response​

Data model: CommonResultPageResultOpenAccountFlowResponse

Response Fields​

code
integer
Description
Error code
msg
string
Description
Human-readable error message
message
string
View child fields
total
integer (int64)
Description
Total
list
array<object (OpenAccountFlowResponse)>
Description
Data

Query Recharge Details​

POST /abc/v1/account/recharge/query

Queries the primary account's deposit records and their processing statuses.

Request Headers​

X-API-Key
string
example
{apiKey}
X-Timestamp
integer
example
{{Timestamp}}
X-Nonce
string
example
{{Nonce}}
X-Signature
string
example
{{Signature}}
Content-Type
string
example
application/json

Request Body​

Data model: OpenRechargeFlowQueryRequest

pageNo
integerRequired
Description
Page number, starting from 1
Range：≥1
Default：1
Example：1
pageSize
integerRequired
Description
Items per page, maximum 200
Range：≥1
Default：10
Example：10
accountFlowId
string
Description
Fund account transaction flow ID
Example / Default
2108839919989616642
parentAccountId
string
Description
primary account ID
Example / Default
210945783621084760203
currency
string
Description
currency code ISO 4217
Example / Default
USD
transTypes
arrayinteger>Required
Description
Transaction type array
Allowed values：
1self-service recharge
2outgoing transfer
3incoming transfer
4fee deduction
6manual recharge
7adjustment increase
8adjustment decrease
9refund
Items：≤8
rechargeMethod
integer
Description
Recharge method
Allowed values：
1USD transfer
5USDT transfer
6rebate-to-recharge
7balance transfer
8account adjustment
Example：5
transStatus
integer
Description
Transaction status
Allowed values：
1success
2failure
3pending
4processing
Range：1–4
Example：1
transactionTime
arraystring>
Description
Transaction time range: [start time, end time]
Items：2

Successful Response​

Data model: CommonResultPageResultOpenAccountFlowResponse

Response Fields​

code
integer
Description
Error code
msg
string
Description
Human-readable error message
message
string
View child fields
total
integer (int64)
Description
Total
list
array<object (OpenAccountFlowResponse)>
Description
Data