---
title: "Get transaction history"
method: POST
path: "/api/v2/transactions"
tags: ["External Wallet Access Mode"]
---

# Get transaction history

`POST /api/v2/transactions`

Returns the user's transaction history with date range, type, currency, direction, and amount filters plus cursor pagination. Timestamps are Unix seconds.

## Headers

- `tokenId` string, required
- `network` string, required
- `sign` string, required
- `hash` string, required
- `deadline` string, required

## Request body

- object
  - `pageSize` integer — Page size (default 50).
  - `fromTimestamp` integer — Start timestamp (Unix seconds).
  - `toTimestamp` integer — End timestamp (Unix seconds).
  - `type` string — Single transaction type, e.g. P2P, FRX, CTU, CRD, CDP. Mutually exclusive with transactionTypes.
  - `transactionTypes` string[] — Multiple transaction-type filter. Mutually exclusive with type.
  - `currencys` string[] — Currency filter, e.g. EUR, USD, CHF.
  - `direction` string — IN, OUT, or ALL.
  - `minAmount` string — Minimum amount filter.
  - `maxAmount` string — Maximum amount filter.
  - `status` string — Transaction status filter.
  - `chainId` string — CAIP-2 chain ID, e.g. eip155:5000.
  - `tokenSymbol` string — Token symbol, e.g. USDC.
  - `cursorTimestamp` integer — Forward-pagination cursor timestamp.
  - `cursorId` integer — Forward-pagination cursor ID.
  - `id` integer — Query a single transaction by record ID. Mutually exclusive with txHash.
  - `txHash` string — Query a single transaction by hash. Mutually exclusive with id.

## Response `200`

Response envelope. For the user API, retCode 0 means success; for the partner API, code 0 means success. Business rejections return HTTP 200 with a non-zero code.

- EwaEnvelope — Standard response envelope for the user API (api.ur.app).
  - `retCode` integer, required — 0 on success; non-zero indicates failure.
  - `retMsg` string, required — Human-readable message; error details when retCode is non-zero.
  - `result` unknown
  - `timeNow` integer — Server timestamp in milliseconds.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)