---
title: "Get User Transactions"
method: GET
path: "/defi/v1/chain/getusertransactions"
tags: ["chain"]
---

# Get User Transactions

`GET /defi/v1/chain/getusertransactions`

## Request

- Base URL: `https://svc.blockdaemon.com`
- URL: `https://svc.blockdaemon.com/defi/v1/chain/getusertransactions`
- Auth: API key in header `X-API-Key`

Retrieves historical transaction details for one or more user addresses over a defined block range, including both simple native transfers and complex contract interactions. For each transaction, the response provides the hash, nonce, sender/receiver addresses, value, gas details, block info, and any ERC20/NFT/native token transfers, along with summaries, categorization (send, receive, etc.), and pagination via a next-page token.

> 💡 
**Compute Unit Value:** `245` (Fixed)

## Query parameters

- `chainId` '43115' | '43116' | '43114' | '1' | '56' | '137' | '250' | '10' | '42161' | '25' | '8453' | '1100' | '1101' | '900' | '1500' | '1501' | '1600' | '1601' | '1700' | '1701' | '1800' | '1400': The unique ID to direct queries or transactions to the correct blockchain. Find more [here](https://docs.blockdaemon.com/docs/defi-api-supported-protocols#supported-chains).
- `chainSymbol` string: The abbreviated chain name for queries or transactions.
- `address` string, required: The public address of the user.
- `endBlock` string: The ending block number from which to get the transactions. By default, the current block.
- `startBlock` string: The starting block number from which to get the transactions. By default, the Genesis block.
- `pageToken` string: The page cursor present at the top to fetch the next page.
- `sortOrder` 'desc' | 'asc': The transaction sorting order. 'asc' or 'desc'. By default, desc.
- `pageSize` string: The number of transactions to fetch per page. By default, 30. Max: 100.
- `fromTimestamp` string: The start date (in seconds or date string) from which to get the transactions. If 'startBlock' is also provided, 'startBlock' will be used.
- `toTimestamp` string: The end date (in seconds or date string) from which to get the transactions. If 'endBlock' is also provided, 'endBlock' will be used.
- `limit` string: Maximum number of transactions in response. Maximum: 5.
- `beforeBlock` string: The block number before which the user wants the transactions.
- `afterBlock` string: The block number after which the user wants the transactions.

## Response `200`

Successful response

- object
  - `status` integer
  - `msg` string
  - `data` object

---

[API](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api.md) - [All operations](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockdaemon/apis/blockdaemon-defi-api/revisions/ec053b7c8041?raw)