Query Wallet Synchronization Info
Get the blockchain synchronization status of a wallet.
Request
VIEW
GET /v1/sofa/wallets/{WALLET_ID}/blocks
Withdrawal Wallet Deposit Wallet Deposit-withdrawal Wallet Delegated Wallet
Response Body
| Field | Type | Description |
|---|---|---|
| latest_block_height | int64 | The latest block height on blockchain |
| synced_block_height | int64 | The current synced block height |
Sample Request
API
/v1/sofa/wallets/677414/blocks
Response Body
{
"latest_block_height": 29317651,
"synced_block_height": 28529203
}
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 |
Sample cURL Command
Designed for the mock server
curl -X GET 'http://localhost:8889/v1/mock/wallets/{WALLET_ID}/blocks'