---
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.testnet.paradex.trade/v1`
- URL: `https://api.testnet.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

- **2025-12-24** `e0dd7ef9404f`: 3 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
- **2025-11-06** `db2cbf7b9c5f`: 1 info
  - added the new optional `query` request parameter `season`
- **2025-11-03** `acfd4cdd0775`: 1 info
  - removed the non-success response with the status `500`
- **2025-10-27** `a1340269c918`: 1 info
  - endpoint added

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

---

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