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

# Get Account Summary

> Retrieve the information on the TRON account for a given address including account balance, frozen TRX, and voting details.



## OpenAPI

````yaml GET /api/v1/tron/{network}/account/{address}
openapi: 3.0.0
info:
  title: Staking API
  description: API used for staking
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.p2p.org/api
security:
  - bearer: []
tags:
  - name: Aptos
    description: Aptos staking operations (stake, unstake, withdraw, claim).
  - name: Celestia
    description: Celestia staking operations (stake, unstake, redelegate, claim).
  - name: Cosmos
    description: Cosmos Hub staking operations (stake, unstake, redelegate, claim).
  - name: EigenLayer
    description: EigenLayer restaking operations.
  - name: Ethereum
    description: Ethereum staking operations (direct, SSV, pooled).
  - name: Hyperliquid
    description: Hyperliquid staking operations.
  - name: Monad
    description: Monad staking operations (delegate, undelegate, withdraw).
  - name: P2P SSV
    description: P2P-managed SSV validator operations (deposit, claim, withdraw).
  - name: Polkadot
    description: Polkadot staking and nomination pool operations.
  - name: Polygon
    description: Polygon staking operations.
  - name: Pooled Staking
    description: Pooled staking vault operations (deposit, unstake, withdraw).
  - name: Sei
    description: Sei staking operations (stake, unstake, redelegate, claim).
  - name: Solana
    description: Solana staking operations (stake, split, merge, deactivate, withdraw).
  - name: SSV
    description: SSV network validator operations.
  - name: Story
    description: Story network staking operations.
  - name: Sui
    description: Sui staking operations.
  - name: TON
    description: TON staking operations (single nominator, whales pool).
  - name: TRON
    description: TRON staking operations (freeze, delegate, vote, withdraw).
  - name: Unified
    description: Unified multi-chain staking interface.
paths:
  /api/v1/tron/{network}/account/{address}:
    get:
      tags:
        - TRON
      summary: Get Account Summary
      description: >-
        Retrieve the information on the TRON account for a given address
        including account balance, frozen TRX, and voting details.
      operationId: tron-account-get
      parameters:
        - name: network
          required: true
          in: path
          description: >-
            <p>TRON network:</p><ul><li>`mainnet` — TRON
            mainnet.</li><li>`testnet-nile` — TRON testnet.</li></ul>
          schema:
            enum:
              - mainnet
              - testnet-nile
            type: string
        - name: address
          required: true
          in: path
          description: TRON account address.
          schema:
            format: tron-address
            nullable: false
            example: TNDzfERDpxLDS2w1q6yaFC7pzqaSQ3Bg3r
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - type: object
                    properties:
                      result:
                        $ref: '#/components/schemas/TronGetAccountResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        $ref: >-
                          #/components/schemas/TronGetAccountStatusFailedException
              examples:
                GetAccountStatusFailedException:
                  value:
                    error:
                      code: 125111
                      message: >-
                        Account status could not be retrieved or contains
                        invalid data. Please ensure the address is correct and
                        try again.
                      name: GetAccountStatusFailedException
                      type: client
                    result: null
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        oneOf:
                          - $ref: '#/components/schemas/AuthNoTokenException'
                          - $ref: '#/components/schemas/AuthWrongTokenException'
              examples:
                NoTokenException:
                  value:
                    error:
                      code: 101111
                      message: >-
                        No Bearer token has been provided. To obtain an
                        authentication token, follow the instructions at
                        https://docs.p2p.org/docs/authentication.
                      name: NoTokenException
                      type: authentication
                    result: null
                WrongTokenException:
                  value:
                    error:
                      code: 101109
                      message: >-
                        An invalid Bearer token has been provided. Please
                        specify the correct authentication token.
                      name: WrongTokenException
                      type: authentication
                    result: null
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
        - bearer: []
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        error:
          type: object
          nullable: true
          default: null
          description: Error object. Always null on successful responses.
        result:
          type: object
          description: Response payload containing the requested data.
      description: Standard API success response envelope wrapping the result payload.
      required:
        - error
        - result
    TronGetAccountResponse:
      type: object
      properties:
        address:
          type: string
          description: Address of the TRON account in the base58 format.
          example: TQ5N6Znhy92Yq2a4YDosMkbqygXgU5Ykh
        balance:
          type: number
          description: >-
            Total amount of tokens in SUN staked by the account (1 TRX = 10⁶
            SUN).
          example: 250000000
          format: double
        availableVotes:
          type: integer
          format: int32
          description: Number of votes available to assign to the Super Representatives.
          example: 500
        usedVotes:
          type: integer
          description: Number of votes already used by this address.
          example: 1500
          format: int32
        totalVotes:
          type: integer
          format: int32
          description: >-
            Total number of votes granted to this account based on the total
            amount of frozen TRX.
          example: 2000
        votes:
          type: object
          description: 'List of key-value pairs: vote address and the vote count.'
          example:
            TLGQ9jXwWXsy8sxkXoXKVLfV7Qe64Q8Yh1: 1000
            TKTcsyw81V4WsqfK8AYx7zoXvD3QycjCkg: 500
        voteList:
          description: List of vote entries for this account.
          example:
            - voteAddress: TLGQ9jXwWXsy8sxkXoXKVLfV7Qe64Q8Yh1
              voteCount: 1000
            - voteAddress: TKTcsyw81V4WsqfK8AYx7zoXvD3QycjCkg
              voteCount: 500
          type: array
          items:
            type: string
        hasEnergyStake:
          type: boolean
          description: >-
            Boolean flag indicating if the account has frozen TRX for the
            `ENERGY` type of resources.
          example: true
        hasBandwidthStake:
          type: boolean
          description: >-
            Boolean flag indicating if the account has frozen TRX for the
            `BANDWIDTH` type of resources.
          example: false
        createdAt:
          type: string
          description: Timestamp of the report generation in the ISO 8601 format.
          example: '2025-06-10T11:42:15.000Z'
          readOnly: true
        netUsage:
          type: integer
          description: Total amount of bandwidth points consumed by the account.
          example: 432
          format: int64
        accountCreatedAt:
          type: string
          description: Timestamp of the account creation in the ISO 8601 format.
          example: '2023-09-15T07:20:35.000Z'
        lastOperationAt:
          type: string
          description: >-
            Timestamp of the last operation performed by the account in the ISO
            8601 format.
          example: '2025-06-08T09:17:42.000Z'
      required:
        - address
        - balance
        - availableVotes
        - usedVotes
        - totalVotes
        - votes
        - voteList
        - hasEnergyStake
        - hasBandwidthStake
        - createdAt
    ExceptionResponse:
      type: object
      properties:
        error:
          type: object
          description: Error object containing exception details. Null on success.
        result:
          type: object
          nullable: true
          default: null
          description: Result payload. Always null on error responses.
        requestId:
          type: string
          description: >-
            Identifier of the request (the `x-request-id` header). Quote this
            value to correlate the response with server logs.
          example: 90c16e9e-6e99-4651-a033-60290356df2f
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the error response was generated.
          example: '2026-05-20T22:29:03.126Z'
      description: Standard API error response envelope wrapping the exception details.
      required:
        - error
        - result
        - timestamp
    TronGetAccountStatusFailedException:
      type: object
      properties:
        type:
          type: string
          default: client
          example: client
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 125111
          example: 125111
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            Account status could not be retrieved or contains invalid data.
            Please ensure the address is correct and try again.
          example: >-
            Account status could not be retrieved or contains invalid data.
            Please ensure the address is correct and try again.
          description: Human-readable error message describing what went wrong.
        errors:
          description: Validation error details when applicable.
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorResponse'
        name:
          type: string
          default: GetAccountStatusFailedException
          example: GetAccountStatusFailedException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - errors
        - name
    AuthNoTokenException:
      type: object
      properties:
        type:
          type: string
          default: authentication
          example: authentication
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101111
          example: 101111
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            No Bearer token has been provided. To obtain an authentication
            token, follow the instructions at
            https://docs.p2p.org/docs/authentication.
          example: >-
            No Bearer token has been provided. To obtain an authentication
            token, follow the instructions at
            https://docs.p2p.org/docs/authentication.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: NoTokenException
          example: NoTokenException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    AuthWrongTokenException:
      type: object
      properties:
        type:
          type: string
          default: authentication
          example: authentication
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101109
          example: 101109
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            An invalid Bearer token has been provided. Please specify the
            correct authentication token.
          example: >-
            An invalid Bearer token has been provided. Please specify the
            correct authentication token.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: WrongTokenException
          example: WrongTokenException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    ValidationErrorResponse:
      type: object
      properties:
        property:
          type: string
          description: Name of the property that failed validation.
        constraints:
          type: object
          additionalProperties:
            type: string
          description: Validation constraint details describing what was expected.
      required:
        - property
        - constraints
  responses:
    TooManyRequests:
      description: >-
        Too Many Requests — the client exceeded its rate limit. The response
        advertises when to retry and the active quota via headers.
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          schema:
            type: integer
            example: 60
        RateLimit-Limit:
          description: >-
            The request quota (maximum number of requests) for the most
            restrictive applicable window.
          schema:
            type: integer
            example: 120
        RateLimit-Reset:
          description: >-
            Number of seconds until the rate-limit window resets and requests
            are accepted again.
          schema:
            type: integer
            example: 60
        RateLimit-Policy:
          description: >-
            The active rate-limit policy as `<limit>;w=<window-seconds>`,
            comma-separated when multiple windows apply.
          schema:
            type: string
            example: 120;w=60
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: integer
                  name:
                    type: string
                    example: ThrottlerException
                  message:
                    type: string
                    example: ThrottlerException
                  errors:
                    type: array
                    nullable: true
                    items:
                      type: object
              result:
                type: object
                nullable: true
                example: null
              requestId:
                type: string
                description: >-
                  Identifier of the request (the `x-request-id` header). Quote
                  this value to correlate the response with server logs.
                example: 90c16e9e-6e99-4651-a033-60290356df2f
              timestamp:
                type: string
                format: date-time
                description: ISO 8601 timestamp of when the error response was generated.
                example: '2026-05-20T22:29:03.126Z'
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Get Account Summary](/reference/eth-pool-account-info.md)
- [Get Account Summaries](/reference/eth-pool-account-info-list.md)
- [Getting Started](/docs/staking-tron.md)
- [Get Delegator Summary](/reference/data-delegator-summary.md)
- [Get Portfolio Summary](/reference/get-positions-summary.md)
