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

# Get user fee balances

> Get authenticated user's fee balances across all types and currencies



## OpenAPI

````yaml post /get-user-fees
openapi: 3.0.3
info:
  title: Token Layer API
  version: 1.0.0
  description: |2-

          Token Layer is an omnichain token trading platform where users can create and trade tokens across multiple chains.

          This API provides comprehensive access to token operations, trading, earnings,
          blockchain transactions, and portfolio management.

          ## Base URL
          All endpoints are accessed via: `https://api.tokenlayer.network/{endpoint}`

          ## Authentication
          Most endpoints require authentication using an JWT token or API key passed as a Bearer token in the Authorization header.

          ## Rate Limiting
          API calls are rate limited per user. Please implement appropriate backoff strategies.
        
  contact:
    name: Token Layer API Support
    url: https://app.tokenlayer.network
servers:
  - url: https://api.tokenlayer.network/functions/v1
    description: Production server
  - url: https://api.tokenlayer.network/functions/v1
    description: Staging server
security: []
tags:
  - name: Tokens
    description: Token creation, browsing, search, trading, and price operations
  - name: Transactions
    description: Blockchain transactions (send, tip, ownership checks)
paths:
  /get-user-fees:
    post:
      tags:
        - Fees
      summary: Get user fee balances
      description: Get authenticated user's fee balances across all types and currencies
      operationId: getUserFees
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
                  format: uuid
                chains:
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  balances:
                    type: array
                    items:
                      type: object
                      properties:
                        currency_address:
                          type: string
                        chain:
                          type: string
                        total_earned:
                          type: string
                        claimable_amount:
                          type: string
                        total_earned_with_decimals:
                          type: string
                        claimable_amount_with_decimals:
                          type: string
                        decimals:
                          type: number
                          nullable: true
                        last_distribution_at:
                          type: string
                          nullable: true
                      required:
                        - currency_address
                        - chain
                        - total_earned
                        - claimable_amount
                        - total_earned_with_decimals
                        - claimable_amount_with_decimals
                        - decimals
                        - last_distribution_at
                  summary:
                    type: object
                    properties:
                      total_traders_referred:
                        type: number
                      total_rewards_earned_usd:
                        type: string
                      total_claimable_usd:
                        type: string
                    required:
                      - total_traders_referred
                      - total_rewards_earned_usd
                      - total_claimable_usd
                required:
                  - balances
                  - summary
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Unauthorized - Invalid or missing authentication
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token or API key

````