> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.kravata.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet Balance

> Returns the balance of one custody wallet of a user.

#### Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | `Bearer <access_token>` obtained from **POST /api/v1/client/token**. |
| user_id | Path | Yes | Owner of the wallet. |
| wallet_id | Path | Yes | Wallet to query, from **GET /admin/wallets/&#123;user_id&#125;**. |

#### Response

| Field | Description |
| --- | --- |
| walletId | Wallet queried. |
| userId | Owner of the wallet. |
| symbol | Token of the balance. |
| network | Network of the wallet. |
| availableBalance | Funds available to operate. |
| visibleBalance | Balance shown to the user. |
| inPoolBalance | Funds held in the liquidity pool. |
| totalOperations | Number of operations of the wallet. |
| lastOperationDate | Timestamp of the last operation, or `null`. |

Returns zeros when the wallet has no movements. Returns 404 when the wallet does not exist or belongs to another user.



## OpenAPI

````yaml /stack/openapi.json get /api/v1/admin/wallets/{user_id}/{wallet_id}/balance
openapi: 3.1.0
info:
  title: Kravata Stack API
  version: '2.0'
  description: >-
    Kravata Stack API: users, accounts, custody wallets, liquidity ramps and
    fiat payments.
servers:
  - url: https://test-api-kore.kravata.co
    description: Test
  - url: https://partners-api.kravata.co
    description: Production (mTLS + IP allowlist)
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Users
  - name: Accounts
  - name: Earn
  - name: Custody
  - name: Liquidity Ramps
  - name: Payments
  - name: Webhooks
paths:
  /api/v1/admin/wallets/{user_id}/{wallet_id}/balance:
    get:
      tags:
        - Custody
      summary: Get Wallet Balance
      description: >-
        Returns the balance of one custody wallet of a user.


        #### Request


        | Field | Type | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | `Bearer <access_token>` obtained from
        **POST /api/v1/client/token**. |

        | user_id | Path | Yes | Owner of the wallet. |

        | wallet_id | Path | Yes | Wallet to query, from **GET
        /admin/wallets/&#123;user_id&#125;**. |


        #### Response


        | Field | Description |

        | --- | --- |

        | walletId | Wallet queried. |

        | userId | Owner of the wallet. |

        | symbol | Token of the balance. |

        | network | Network of the wallet. |

        | availableBalance | Funds available to operate. |

        | visibleBalance | Balance shown to the user. |

        | inPoolBalance | Funds held in the liquidity pool. |

        | totalOperations | Number of operations of the wallet. |

        | lastOperationDate | Timestamp of the last operation, or `null`. |


        Returns zeros when the wallet has no movements. Returns 404 when the
        wallet does not exist or belongs to another user.
      operationId: get-wallet-balance
      parameters:
        - name: user_id
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
        - name: wallet_id
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  walletId:
                    type: string
                  userId:
                    type: string
                  symbol:
                    type: string
                  network:
                    type: string
                  visibleBalance:
                    type: number
                  inPoolBalance:
                    type: number
                  availableBalance:
                    type: number
                  totalOperations:
                    type: integer
                  lastOperationDate:
                    type: string
              examples:
                wallet-balance:
                  summary: Wallet balance
                  value:
                    walletId: 657489da-9578-4f5c-b7f1-0d41e91908d1
                    userId: e097845b-20b1-4805-9708-740cbcf5d524
                    symbol: USDC
                    network: POLYGON
                    visibleBalance: 125.5
                    inPoolBalance: 0
                    availableBalance: 125.5
                    totalOperations: 4
                    lastOperationDate: '2026-06-05T01:06:44.548434'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Access token from POST /api/v1/client/token.

````