POST/openapi/v1/wallets

List Team Wallets

Query all wallet information for the current team. Results can be filtered by wallet type.

Rate limit: 1000 requests/minute

Request

Headers

Access-Keystringrequired
API Key identifier used to identify the caller.
Access-Timestampinteger<int64>required
Unix timestamp in milliseconds.
Access-Noncestringrequired
Random string used to prevent replay attacks.
Access-Signaturestringrequired
Request signature calculated with the Access Secret.

Request Body

required

application/json

page_numinteger<int32>
Page number. Defaults to 1 if omitted.
page_sizeinteger<int32>
Number of records per page. Defaults to 10 if omitted. Maximum value is 100.
wallet_typestring
enum: "single_sign", "multi_sign"
Wallet type to query.
- single_signsingle-signature wallet
- multi_signmulti-signature wallet
If omitted, all wallet types are queried by default.

Responses

200Success

application/json

codestring
Response code.
msgstring
Response message.
dataobject
Response data.
- totalinteger<int64>
  Total number of records.
- page_numinteger<int32>
  Current page number.
- page_sizeinteger<int32>
  Number of records per page.
- rowsarray
  Wallet list.
  Array items
  wallet_idinteger<int64>
  Wallet ID.
  aliasstring
  Wallet name, 2-20 characters, displayed in the Cregis portal.
  wallet_typestring
  enum: "single_sign", "multi_sign"
  Wallet type
  
  single_signsingle-signature wallet
  
  multi_signmulti-signature wallet
  
  wallet_statusstring
  enum: "normal"
  Wallet status
  
  normalnormal
  
  create_timeinteger<int64>
  Wallet creation time, 10-digit Unix timestamp.
  tokensarray
  All token information configured for the wallet.
  Array items
  chain_idstring
  Blockchain ID.
  chain_namestring
  Blockchain name.
  token_idstring
  Token ID.
  token_namestring
  Token name.

Try it

This endpoint is signed server-side; no key needed here.

Access-Key(header)*

Access-Timestamp(header)*

Access-Nonce(header)*

Access-Signature(header)*

Request body (JSON)

Request example

application/json

{
  "page_num": 1,
  "page_size": 10
}

Response example

200 · application/json

{
  "code": "00000",
  "msg": "ok",
  "data": {
    "total": 1,
    "page_num": 1,
    "page_size": 10,
    "rows": [
      {
        "wallet_id": 1395142548643840,
        "alias": "Cregis wallet",
        "wallet_type": "single_sign",
        "wallet_status": "normal",
        "create_time": 1721900581,
        "tokens": [
          {
            "chain_id": "195",
            "chain_name": "TRON",
            "token_id": "195",
            "token_name": "USDT-TRC20"
          }
        ]
      }
    ]
  }
}