Skip to main content
POST
/
v1
/
getBalance
GetBalance
curl --request POST \
  --url https://api.mpcvault.com/v1/getBalance \
  --header 'Content-Type: application/json' \
  --header 'x-mtoken: <api-key>' \
  --data '
{
  "networkType": "NETWORK_TYPE_UNKNOWN",
  "chainId": "<string>",
  "walletAddress": "<string>",
  "tokenAddress": "<string>"
}
'
{
  "balance": "<string>",
  "error": {
    "executeSigningRequestsErrorCode": "EXECUTE_SIGNING_REQUESTS_ERROR_CODE_UNSPECIFIED",
    "message": "<string>"
  }
}
Returns the balance for a wallet address—native token or a specific ERC-20/SPL token. Balance is a string for precision; use the token’s decimals to convert (e.g. ETH 18, USDC 6, SOL 9).

Authorizations

​
x-mtoken
string
header
required

Your API token. Required for all API requests.

Body

application/json
​
networkType
enum<string>

required:true symbol_value:"1" default:null comment:network_type is the type of the network.

Available options:
NETWORK_TYPE_UNKNOWN,
NETWORK_TYPE_EVM,
NETWORK_TYPE_BITCOIN,
NETWORK_TYPE_TRON,
NETWORK_TYPE_APTOS,
NETWORK_TYPE_SUI,
NETWORK_TYPE_SOLANA,
NETWORK_TYPE_TON,
NETWORK_TYPE_STELLAR
​
chainId

symbol_value:"137" default:null comment chain_id is the chain id of the network.

​
walletAddress
string

required:true symbol_value:"8HrKVJeFNGSJ2T2wSU6MxfMvua2MYgwH1FbRsdfrgthj" default:null comment:wallet_address this is the wallet address.

​
tokenAddress
string

symbol_value:"0x71C7656EC7ab88bd32g47dgdhhssq245f6d8976F" default:null comment:token_address this is the token address,if not set, it will return the balance of the native token.

Response

200 - application/json

Success

​
balance
string

symbol_value:0.12128 comment:The balance is in the smallest denomination.

​
error
execute_signing_requests_error_code · object

comment:The error is null when success.