---
title: "Get XP Balance (V2)"
method: GET
path: "/xp/account-balance"
tags: ["XPTransfersV2"]
---

# Get XP Balance (V2)

`GET /xp/account-balance`

## Request

- Base URL: `https://api.prod.paradex.trade/v1`
- URL: `https://api.prod.paradex.trade/v1/xp/account-balance`
- Auth: API key in header `Authorization`

Get detailed XP balance including earned XP, transfer delta, and transferrable
amount.

## Query parameters

- `season` string

## Response `200`

OK

- ResponsesGetXPBalanceResponseV2
  - `earned_xp` integer: XP earned through trading (from leaderboard, immutable)
  - `transferrable_xp` integer: Maximum XP that can be transferred
  - `xp_delta` integer: Net XP from transfers

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

## Changes

- **2026-10-22** `f33feb7333ea`: 6 warning
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_NOT_PARADEX_ACCOUNT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `ADDRESS_BOOK_REPEATED_IN_IMPORT` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - …2 more
- **2026-10-20** `72c125c93c2b`: 4 warning
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `SESSION_EXPIRED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
  - added the new `SESSION_REVOKED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `SESSION_REVOKED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `401`
- …earlier changes not shown

[Operation history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/xp/account-balance/get.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) - [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/revisions/f33feb7333ea?raw)