Secure Digital Asset Operations for Institutions

Query Deposit Addresses

Query the deposit addresses created by the Create deposit wallet addresses API.

Request

GET /v1/sofa/wallets/{WALLET_ID}/addresses?start_index={FROM}&request_number={COUNT}

WALLET_ID must be a deposit wallet ID

Query Parameters

Field	Type	Note	Description
start_index	int	optional, default `0`	Specify address start index
request_number	int	optional, default `1000`, max `5000`	Request address count

Response Body

Field	Type	Description
wallet_id	int64	ID of request wallet
wallet_address	array	Array of wallet addresses

Refer to Currency Definition or here for more detailed currency definitions

Error Code

HTTP Code	Error Code	Error	Message	Description
403	-	Forbidden. Invalid wallet ID	-	No wallet ID found
403	-	Forbidden. Header not found	-	Missing `X-API-CODE`, `X-CHECKSUM` header or query param `t`
403	-	Forbidden. Invalid timestamp	-	The timestamp `t` is not in the valid time range
403	-	Forbidden. Invalid checksum	-	The request is considered a replay request
403	-	Forbidden. Invalid API code	-	`X-API-CODE` header contains invalid API code
403	-	Invalid API code for wallet {WALLET_ID}	-	The API code mismatched
403	-	Forbidden. Checksum unmatch	-	`X-CHECKSUM` header contains wrong checksum
403	-	Forbidden. Call too frequently ({THROTTLING_COUNT} calls/minute)	-	Send requests too frequently
404	304	Wallet ID invalid	-	The wallet is not allowed to perform this request

Sample Request

API

/v1/sofa/wallets/56788/addresses?start_index=0&request_number=3

--- THEN ---

/v1/sofa/wallets/56788/addresses?start_index=3&request_number=3

Response Body

{
  "wallet_id": 56788,
  "wallet_address": [
    {
      "currency": 60,
      "token_address": "",
      "address": "0x8c42fD03A5cfba7C3Cd97AB8a09e1a3137Ef33C3",
      "memo": ""
    },
    {
      "currency": 60,
      "token_address": "",
      "address": "0x4d3EB54b602BF4985CE457089F9fB084Af597A2C",
      "memo": ""
    },
    {
      "currency": 60,
      "token_address": "",
      "address": "0x74dc3fB523295C87C0b93E48744Ce94fe3a8Ef5e",
      "memo": ""
    }
  ]
}

--- THEN ---

{
  "wallet_id": 56788,
  "wallet_address": [
    {
      "currency": 60,
      "token_address": "",
      "address": "0x6d68443D6564cF257A48c1b16aa6d0EF13c5A719",
      "memo": ""
    },
    {
      "currency": 60,
      "token_address": "",
      "address": "0x26F103322B6f0ed2D35B85F1611589c92F023986",
      "memo": ""
    },
    {
      "currency": 60,
      "token_address": "",
      "address": "0x2b91918Bee4411DaD6293EA5d6D38251E72723Ca",
      "memo": ""
    }
  ]
}

Sample cURL Command

Designed for the mock server

curl -X GET 'http://localhost:8889/v1/mock/wallets/{WALLET_ID}/addresses?start_index=0&request_number=1000'