# get user balance

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/balance/query:
    post:
      summary: get user balance
      deprecated: false
      description: |
        return result is an object {userid: balance}
        balance amount / 1e12 => \$, ex. 12000000000000 (12 zero) = \$12.00
        if meta_status==1 but the object is empty, means balance is 0
      tags:
        - User/balance
        - balance
      parameters:
        - name: Authorization
          in: header
          description: ''
          example: Bearer {{AUTH_TOKEN}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                credit_type:
                  description: always "user_dollar"
                  type: string
              x-apifox-refs: {}
              x-apifox-orders:
                - credit_type
              required:
                - credit_type
            example:
              credit_type: user_dollar
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta_message:
                    type: string
                    description: success or other error msg
                  meta_status:
                    type: integer
                    description: 1 for success, negative for error
                  result:
                    type: object
                    additionalProperties:
                      type: string
                    x-apifox-orders: []
                    description: user balance object, {id:balance}
                    properties: {}
                x-apifox-refs: {}
                x-apifox-orders:
                  - meta_message
                  - meta_status
                  - result
                required:
                  - meta_message
                  - meta_status
                  - result
          headers: {}
          x-apifox-name: result
      security: []
      x-apifox-folder: User/balance
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/2880121/apis/api-88999345-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.ipcola.com
    description: ipcola
security: []

```