Retrieving token balance ​

Retrieves the token balance of the authorized FIB user's peer account at the time of the request.

Protocol: HTTP

Encoding: JSON

Endpoint: /data/api/v1/wallet-management/balance

Method: GET

Header: Authorization — represented by a string that is the accessToken value that was returned either at the authorization, or the previous time the token has been refreshed.

Input/request structure ​

A GET request to the endpoint with the Authorization header specified.

Output/response structure ​

{
  status: {
    code: integer($int32),
    name: 'string'
  },
  data: {
    tokenId: {
      definitionId: 'assetName#assetDomain',
      accountId: 'accountName@accountDomain'
    },
    balance: integer($int64)
  }
}

{
  status: {
    code: integer($int32),
    name: 'string'
  },
  data: {
    tokenId: {
      definitionId: 'assetName#assetDomain',
      accountId: 'accountName@accountDomain'
    },
    balance: integer($int64)
  }
}

{
  status: {
    code: 200,
    name: 'OK'
  },
  data: {
    tokenId: {
      definitionId: 'credit#admin',
      accountId: 'admin@admin'
    },
    balance: 500
  }
}

{
  status: {
    code: 200,
    name: 'OK'
  },
  data: {
    tokenId: {
      definitionId: 'credit#admin',
      accountId: 'admin@admin'
    },
    balance: 500
  }
}

Responses ​