> ## Documentation Index > Fetch the complete documentation index at: https://docs.tradingapi.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get your account > Returns your balance, your deposit address and whether trading is active, read live from the exchange. If the exchange cannot be read, the response is `503`; the API never guesses. ## OpenAPI ````yaml /openapi.yaml get /v1/account openapi: 3.1.0 info: title: Trading API license: name: Proprietary identifier: LicenseRef-Proprietary version: '1' summary: Trade perpetual futures on Hyperliquid with plain HTTP requests. description: > The Trading API places market orders on Hyperliquid perpetual futures and reports your positions, fills and balance. You never sign anything, manage nonces or look up asset indexes: send a market, a side and a value in US dollars. Every request authenticates with an API key created on the account page: `Authorization: Bearer tapi_…`. servers: - url: https://tradingapi.dev description: Production. Orders trade real money on Hyperliquid mainnet. security: - apiKey: [] tags: - name: Markets description: The markets you can trade, with their rules and current prices. - name: Orders description: Place, preview, list and look up orders. - name: Positions description: Your open positions, and closing them. - name: Account description: Your balance, the calling key, fills and withdrawals. paths: /v1/account: get: tags: - Account summary: Get your account description: > Returns your balance, your deposit address and whether trading is active, read live from the exchange. If the exchange cannot be read, the response is `503`; the API never guesses. operationId: getAccount responses: '200': description: The account. content: application/json: schema: $ref: '#/components/schemas/Account' examples: active: value: object: account equity: '1412.86' available: '212.30' unrealized_pnl: '7.17' deposit_address: '0x9c0f6f2a5d1b3e4c7a8b9d0e1f2a3b4c5d6e7f80' trading: status: active valid_until: '2026-12-23T00:00:00.000Z' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' '503': $ref: '#/components/responses/Unavailable' components: schemas: Account: type: object required: - object - equity - available - unrealized_pnl - deposit_address - trading properties: object: type: string const: account equity: type: string description: Your balance plus unrealized profit and loss, in USD. available: type: string description: What can back new orders or be withdrawn, in USD. unrealized_pnl: type: string deposit_address: type: - string - 'null' description: >- Your deposit address for USDC on Arbitrum. `null` until your account is set up. trading: type: object required: - status - valid_until properties: status: type: string enum: - active - inactive - expired description: >- `active`: you can trade. `inactive`: activate trading on the account page. `expired`: renew it there. valid_until: type: - string - 'null' format: date-time ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' Error: type: object required: - type - code - message - param - hint - details - errors - retryable - doc_url properties: type: type: string enum: - invalid_request - authentication - permission - not_found - conflict - unprocessable - rate_limited - unavailable - internal description: The kind of error. It determines the HTTP status. code: type: string description: >- A stable identifier for the error. Branch on this. New codes may be added. message: type: string description: What was wrong, with the values involved. param: type: - string - 'null' description: The request field at fault, as a JSON path, or `null`. hint: type: - string - 'null' description: One concrete way to fix the request. details: type: object description: The numbers and values the message refers to, as fields. additionalProperties: true errors: type: array description: Every field error, when `code` is `invalid_fields`. Empty otherwise. items: $ref: '#/components/schemas/Error' retryable: type: boolean description: Whether the same request can succeed later, unchanged. retry_after: $ref: '#/components/schemas/Timestamp' description: When a retry can succeed, if known. doc_url: type: string format: uri Timestamp: type: string format: date-time description: >- RFC 3339 in UTC with milliseconds, for example `2026-09-27T14:30:00.123Z`. responses: Unauthorized: description: No valid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_api_key: value: error: type: authentication code: invalid_api_key message: This API key is not valid. It may have been revoked. param: null hint: >- Send a current key as Authorization: Bearer tapi_…. Keys are created and revoked on the account page. details: {} errors: [] retryable: false doc_url: >- https://docs.tradingapi.dev/api-reference/errors#invalid_api_key RateLimited: description: >- The key made too many requests. Each key may make 10 requests at once, then 5 a second. Nothing was done; retry after `Retry-After` seconds. headers: Retry-After: description: The seconds to wait before retrying, always `1`. schema: type: string enum: - '1' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rate_limited: value: error: type: rate_limited code: rate_limited message: This key made too many requests; retry in 1 s. param: null hint: >- Slow down: each key may make 10 requests at once, then 5 a second. details: {} errors: [] retryable: true retry_after: '2026-09-28T14:05:12.000Z' doc_url: >- https://docs.tradingapi.dev/api-reference/errors#rate_limited Unavailable: description: A service we depend on failed. Retry the same request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unavailable: value: error: type: unavailable code: unavailable message: The exchange could not be reached. param: null hint: >- Retry the same request with the same client_order_id; an order may already have been recorded. details: {} errors: [] retryable: true doc_url: https://docs.tradingapi.dev/api-reference/errors#unavailable securitySchemes: apiKey: type: http scheme: bearer bearerFormat: tapi_… description: >- An API key from the account page, sent as `Authorization: Bearer tapi_…`. ````