Verify Deposit Addresses

Verify that these addresses belong to a deposit wallet.

Request

VIEW

POST /v1/sofa/wallets/{WALLET_ID}/receiver/addresses/verify

Deposit Wallet Deposit-withdrawal Wallet Delegated Wallet

Post Body

Field	Type	Note	Description
addresses	array	required	Specify the addresses to be verified

If the address can not be found or invalid, it will not be listed in the response.

Response Body

Field	Type	Description
addresses	key-value pairs	The address-info pairs
label	string	Associated label
create_time	string	Address creation time (UTC)

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
403	385	API Secret not valid	-	Invalid API code permissions
400	112	Invalid parameter	-	Malformatted post body
404	304	Wallet ID invalid	-	The wallet is not allowed to perform this request

Sample Request

API

/v1/sofa/wallets/98675/receiver/addresses/verify

Post Body

{
  "addresses": [
    "0x46d4AD967F68253f61D45a044dC7dC7B13E5A4B3",
    "0x107FF19Ea5fB7de78392e7AcC2A2C7eace891bDc"
  ]
}

Response Body

{
  "addresses": {
    "0x107FF19Ea5fB7de78392e7AcC2A2C7eace891bDc": {
      "create_time": "2021-12-05T16:23:20Z",
      "label": "987444413"
    },
    "0x46d4AD967F68253f61D45a044dC7dC7B13E5A4B3": {
      "create_time": "2021-12-05T16:23:20Z",
      "label": ""
    }
  }
}

Sample cURL Command

Designed for the mock server

curl -X POST -H "Content-Type: application/json" -d '{"addresses":["0x46d4AD967F68253f61D45a044dC7dC7B13E5A4B3","0x107FF19Ea5fB7de78392e7AcC2A2C7eace891bDc"]}' \
http://localhost:8889/v1/mock/wallets/{WALLET_ID}/receiver/addresses/verify