First API Call

Getting Started: Get Balances

This endpoint allows customers to quickly obtain real-time information about the current state of their accounts, including the available balance and any pending transactions that might affect this balance.

This API endpoint is a GET request, which makes it a great endpoint for inital testing as it's configuration is relatively simple and straightforward. Remember to configure your request's header with both Authorization and otp fields.

---

Get Account Balances

Fetches a list of the user’s asset accounts along with the current balances, including total, available, and pending balances. This endpoint is essential for users to obtain a clear overview of their financial status within the system.

• Endpoint: /api/v1/customer/accounts/balances

• Method: GET

List of asset accounts

Response:

• assetAccountId: Asset account ID
• asset: Asset account asset
• totalBalance: Total balance
• availableBalance: Total balance minus incoming pending transaction amounts
• pendingBalance: Sum of pending transaction amounts

GEThttps://public-api.ibanera.com/api/v1/customer/accounts/balances

Query parameters

Header parameters

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsnullable array of AvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.AccountsDto (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

Request

JavaScriptCurlPython

const response = await fetch('https://public-api.ibanera.com/api/v1/customer/accounts/balances', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200400

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": [
    {
      "id": 0,
      "asset": "text",
      "totalBalance": 0,
      "availableBalance": 0,
      "pendingBalance": 0,
      "bSuppressed": false
    }
  ],
  "pageSize": 0,
  "pageNumber": 0,
  "numberOfPages": 0
}

Query Parameters:

• pageNumber (Integer, Optional): The page of results to return.

• pageSize (Integer, Optional): The maximum number of results to return.

If pageNumber and pageSize are not supplied, then an unpaginated list will be returned.

Request Example:

To request the first page with ten results:

GET /api/v1/customer/accounts/balances?pageNumber=1&pageSize=10

Response Body Parameters:

• id (Integer): Not used in the example.

• details (Array of Objects): Each object contains the details of an asset account balance.

  • id (Integer): The ID of the asset account.

  • asset (String): The type of asset the account holds.

  • totalBalance (Decimal): The total balance in the account.

  • availableBalance (Decimal): The available balance that is ready for use.

  • pendingBalance (Decimal): The balance that is currently in pending transactions and not yet cleared.

  • bSuppressed (Boolean): Indicates whether the use of this account is currently disabled.

Success Response Example:

{
  "id": 0,
  "details": [
    {
      "id": 1000,
      "asset": "USDC",
      "totalBalance": 100.00,
      "availableBalance": 98.00,
      "pendingBalance": 2.00,
      "bSuppressed": false
    }
  ],
  "pageSize": 10,
  "pageNumber": 1,
  "status": "1",
  "errors": []
}