---
title: "Get XP transfer offers for an account"
method: GET
path: "/xp/offers"
tags: ["XPTransfers"]
---

# Get XP transfer offers for an account

`GET /xp/offers`

Get XP transfer offers for an account. If role is not specified, returns all
offers (both as maker and taker). If role is specified, filters by that role
only.

## Query parameters

- `role` 'maker' | 'taker'
- `cursor` string
- `page_size` integer

## Response `200`

List of offers retrieved successfully

- object
  - `next` string — The pointer to fetch next set of records (null if there are no records left)
  - `prev` string — The pointer to fetch previous set of records (null if there are no records left)
  - `results` object[] — Array of paginated results
    - `claimed_at` integer — Claim timestamp (nanoseconds since epoch, 0 if not claimed)
    - `created_at` integer — Creation timestamp (nanoseconds since epoch)
    - `expires_at` integer — Expiration timestamp (nanoseconds since epoch)
    - `id` string — Unique offer identifier
    - `maker` string — Address of the maker (seller)
    - `price` string — Price in USDC (as string to handle precision)
    - `sequence` integer — Sequence number for this maker
    - `settled_at` integer — Settlement timestamp (nanoseconds since epoch, 0 if not settled)
    - `taker` string — Address of the taker (buyer)
    - `tx_hash` string — Transaction hash (empty if not claimed)
    - `xp_amount` integer — Amount of XP to transfer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2025-08-29** `6607d97fbf07` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api/changes/xp/offers/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-service-production.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api/revisions/39d263b59c8e/schema)