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'