Get Wallet Balance
GET
https://api-prod.useknit.io/api/v1/managed-signing/wallets/{walletId}/balance
This endpoint fetches the balance of a single token for an EVM wallet. This is a live query to the blockchain — no balance data is stored locally.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
walletId | string | Yes | The local wallet ID returned by create/list endpoints |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
network | string | Yes | Target network (e.g., ETH_MAINNET, MATIC_MAINNET) |
contractAddress | string | No | ERC20 token contract address |
tokenSymbol | string | No | Token symbol (e.g., USDC, USDT) |
Note: If both contractAddress and tokenSymbol are provided, contractAddress takes precedence. If only tokenSymbol is provided, the token is resolved from the supported tokens for that network.
Request
curl "https://api-prod.useknit.io/api/v1/managed-signing/wallets/<local-wallet-id>/balance?network=ETH_MAINNET&tokenSymbol=USDC" \
-H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
-H "Accept: application/json"Response
Response
{
"statusCode": 200,
"message": "Wallet balance fetched",
"data": {
"tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"tokenSymbol": "USDC",
"decimals": 6,
"balanceRaw": "1200000",
"balanceFormatted": "1.2"
},
"success": true
}Response Fields
| Field | Type | Description |
|---|---|---|
tokenAddress | string | ERC20 token contract address |
tokenSymbol | string | Token symbol |
decimals | number | Token decimal places |
balanceRaw | string | Raw balance in base units (e.g., wei) |
balanceFormatted | string | Human-readable balance |
Common Errors
| Status | Message | Description |
|---|---|---|
| 400 | network is required | Missing required network query parameter |
| 400 | Unsupported network ... | Network not in supported list |
| 400 | Wallet is not active on network ... | Wallet not configured for the requested network |
| 400 | Provide contractAddress, or provide tokenSymbol... | Missing token identifier |
| 404 | Wallet not found | Invalid or non-existent wallet ID |
