> For the complete documentation index, see [llms.txt](https://noodles-finance.gitbook.io/docs.noodles.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://noodles-finance.gitbook.io/docs.noodles.fi/accounts/tx-history.md).

# Account's Tx History

### **Endpoint**

```
GET /api/v1/partner/portfolio/tx-history
```

***

### **Request Parameters**

| Name       | Type   | Required | Description                                                                |
| ---------- | ------ | -------- | -------------------------------------------------------------------------- |
| `address`  | string | Yes      | The wallet address to fetch transaction history for.                       |
| `limit`    | int    | No       | Number of records to return (default: 20, max: 20).                        |
| `cursor`   | string | No       | Transaction digest to use as a cursor for pagination.                      |
| `activity` | string | No       | Filter transactions by activity type.                                      |
| `protocol` | string | No       | Filter transactions by protocol (e.g., `cetus-clmm`, `turbos-clmm`, etc.). |
| `from`     | int    | No       | Filter start time (timestamp miliseconds) for filtering transactions.      |
| `to`       | int    | No       | Filter to date (timestamp miliseconds) for filtering transactions.         |

**List of supported protocols:**

| Protocol Key     | Protocol Name     |
| ---------------- | ----------------- |
| `magma-clmm`     | Magma             |
| `steamm-cpmm`    | STEAMM            |
| `momentum-clmm`  | Momentum          |
| `interest-cpmm`  | Interest Protocol |
| `cetus-clmm`     | Cetus             |
| `bluefin-clmm`   | Bluefin           |
| `kriya-clmm`     | Kriya V3          |
| `kriya-cpmm`     | Kriya V2          |
| `turbos-clmm`    | Turbos            |
| `aftermath-cpmm` | Aftermath         |
| `bluemove-cpmm`  | BlueMove          |
| `flowx-cpmm`     | FlowX V2          |
| `flowx-clmm`     | FlowX V3          |
| `deepbookv3`     | Deepbook V3       |

**List of supported activities:**

| Activity Key           | Description          |
| ---------------------- | -------------------- |
| `send`                 | Sending tokens       |
| `receive`              | Receiving tokens     |
| `swap`                 | Swapping tokens      |
| `add_liquidity`        | Adding liquidity     |
| `remove_liquidity`     | Removing liquidity   |
| `contract_interaction` | Contract interaction |

**Note:**

* If you want to fetch the latest transactions, omit the `cursor`, `from`, and `to` parameters.
* If you want to filter transactions by date, use the `from` and `to` parameters with timestamps in milliseconds.
* For subsequent pages, include the `cursor` parameter with the transaction digest from the previous response.
* The `limit` parameter is capped at 20 transactions per request.

***

### **Headers**

| Header      | Required | Description                |
| ----------- | -------- | -------------------------- |
| `x-api-key` | Yes      | API key for authorization. |

***

### **cURL Example**

```bash
curl --location 'https://api.noodles.fi/api/v1/partner/portfolio/tx-history?address=0xe9008ec0faa85024b357ebb7aa80cfc081ecf5a77bca299e5b365c627f1bb466&limit=3&cursor=9aZuo7x6ZHtMnEGXbcfyzUsiH7bENGaQFo6NutA295LL' \
--header 'x-api-key: YOUR_API_KEY'
```

***

### **Response**

#### Fields

| Field            | Type     | Nullable | Description                                       |
| ---------------- | -------- | -------- | ------------------------------------------------- |
| `data`           | `array`  | No       | Array of transaction history objects.             |
| `nextPageCursor` | `string` | Yes      | Cursor value to use for the next page of results. |

**Transaction History Object**

| Field                  | Type   | Nullable | Description                                         |
| ---------------------- | ------ | -------- | --------------------------------------------------- |
| `digest`               | string | No       | Transaction digest (used as cursor for pagination). |
| `timestamp_ms`         | string | No       | Transaction timestamp in milliseconds.              |
| `type`                 | string | No       | Transaction type (e.g., `swap`, `transfer`, etc.).  |
| `coin_changes`         | array  | No       | Array of coin changes in the transaction.           |
| `address_interactions` | array  | No       | Addresses that interacted in this transaction.      |
| `gas_fee`              | number | No       | Transaction gas fee.                                |
| `status`               | string | No       | Transaction status (e.g., `success`, `failed`).     |
| `sender`               | string | No       | Sender address.                                     |
| `events`               | array  | No       | Array of events in the transaction.                 |

**Coin Change Object**

| Field       | Type   | Nullable | Description                                    |
| ----------- | ------ | -------- | ---------------------------------------------- |
| `type`      | string | No       | Coin type.                                     |
| `symbol`    | string | No       | Coin symbol.                                   |
| `amount`    | number | No       | Coin amount.                                   |
| `usd_value` | number | No       | USD value of the coin amount.                  |
| `logo`      | string | Yes      | URL to coin logo image.                        |
| `scamFlag`  | number | No       | Flag indicating if the coin is marked as scam. |

**Address Interaction Object**

| Field     | Type   | Nullable | Description                               |
| --------- | ------ | -------- | ----------------------------------------- |
| `address` | string | No       | Interacting address.                      |
| `type`    | string | No       | Type of address (contract, wallet, etc.). |
| `name`    | string | Yes      | Name of the address if available.         |
| `logo`    | string | Yes      | Logo URL for the address if available.    |

#### Success Response

```json
{
    "data": [
        {
            "digest": "4iAvYTNqFiK4sFEAh6zRpaTs3PXTrMU6X8uNnq2SNYYQ",
            "timestamp_ms": "1750048957326",
            "type": "swap",
            "coin_changes": [
                {
                    "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                    "symbol": "SUI",
                    "amount": 0.32294958,
                    "usd_value": 0.917112217284,
                    "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
                    "scamFlag": 0
                },
                {
                    "type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
                    "symbol": "USDC",
                    "amount": -1,
                    "usd_value": -1.00103262,
                    "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/usdc.png/public",
                    "scamFlag": 0
                }
            ],
            "address_interactions": [
                {
                    "address": "0x8093d002bba575f1378b0da206a8df1fc55c4b5b3718752304f1b67a505d2be4",
                    "type": "package",
                    "name": "",
                    "logo": ""
                },
                {
                    "address": "0x25929e7f29e0a30eb4e692952ba1b5b65a3a4d65ab5f2a32e1ba3edcb587f26d",
                    "type": "package",
                    "name": "FlowX V3",
                    "logo": "https://strapi-dev.scand.app/uploads/photo_2023_10_23_09_56_50_7d2b8e58b3.jpg"
                }
            ],
            "gas_fee": 0.001676992,
            "status": "success",
            "sender": "0xe9008ec0faa85024b357ebb7aa80cfc081ecf5a77bca299e5b365c627f1bb466",
            "events": [
                {
                    "action": "swap",
                    "coin_ins": [
                        {
                            "type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
                            "symbol": "USDC",
                            "amount": 1
                        }
                    ],
                    "coin_outs": [
                        {
                            "type": "0xbde4ba4c2e274a60ce15c1cfff9e5c42e41654ac8b6d906a57efa4bd3c29f47d::hasui::HASUI",
                            "symbol": "haSUI",
                            "amount": 0.307216509
                        }
                    ],
                    "protocol": "cetus-clmm"
                },
                {
                    "action": "swap",
                    "coin_ins": [
                        {
                            "type": "0xbde4ba4c2e274a60ce15c1cfff9e5c42e41654ac8b6d906a57efa4bd3c29f47d::hasui::HASUI",
                            "symbol": "haSUI",
                            "amount": 0.324951523
                        }
                    ],
                    "coin_outs": [
                        {
                            "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                            "symbol": "SUI",
                            "amount": 0.307216509
                        }
                    ],
                    "protocol": "flowx-clmm"
                }
            ]
        },
        {
            "digest": "FK7U6Wb4hRFAgCivkRnE8un2mPPWp9QMVDHL1t65Kc44",
            "timestamp_ms": "1750047338465",
            "type": "swap",
            "coin_changes": [
                {
                    "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                    "symbol": "SUI",
                    "amount": 0.977301644,
                    "usd_value": 2.7753412086312,
                    "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
                    "scamFlag": 0
                },
                {
                    "type": "0xcb8fc6858b4d600611cb783a65459695711b8aaca0e949ef5aa1268d1e32f786::suimon::SUIMON",
                    "symbol": "SUIMON",
                    "amount": -2431.739058641,
                    "usd_value": -1.3900041494545432,
                    "logo": "https://strapi-dev.scand.app/uploads/Cetus_f2d8b47579.png",
                    "scamFlag": 0
                }
            ],
            "address_interactions": [
                {
                    "address": "0x0000000000000000000000000000000000000000000000000000000000000002",
                    "type": "package",
                    "name": "Sui",
                    "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public"
                },
                {
                    "address": "0xd02012c71c1a6a221e540c36c37c81e0224907fe1ee05bfe250025654ff17103",
                    "type": "package",
                    "name": "",
                    "logo": ""
                }
            ],
            "gas_fee": 0.00237124,
            "status": "success",
            "sender": "0xe9008ec0faa85024b357ebb7aa80cfc081ecf5a77bca299e5b365c627f1bb466",
            "events": [
                {
                    "action": "swap",
                    "coin_ins": [
                        {
                            "type": "0xcb8fc6858b4d600611cb783a65459695711b8aaca0e949ef5aa1268d1e32f786::suimon::SUIMON",
                            "symbol": "SUIMON",
                            "amount": 2431.739058641
                        }
                    ],
                    "coin_outs": [
                        {
                            "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                            "symbol": "SUI",
                            "amount": 0.980653537
                        }
                    ],
                    "protocol": "turbos-clmm"
                }
            ]
        },
        {
            "digest": "DeeZVSaC234MfhM62wg6ZPTs7yJnRjAfSTZvVNxc95Lx",
            "timestamp_ms": "1750047305697",
            "type": "swap",
            "coin_changes": [
                {
                    "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                    "symbol": "SUI",
                    "amount": -1.020458114,
                    "usd_value": -2.8978969521372,
                    "logo": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui-coin.svg/public",
                    "scamFlag": 0
                },
                {
                    "type": "0xcb8fc6858b4d600611cb783a65459695711b8aaca0e949ef5aa1268d1e32f786::suimon::SUIMON",
                    "symbol": "SUIMON",
                    "amount": 2431.739058641,
                    "usd_value": 1.3900041494545432,
                    "logo": "https://strapi-dev.scand.app/uploads/Cetus_f2d8b47579.png",
                    "scamFlag": 0
                }
            ],
            "address_interactions": [
                {
                    "address": "0x5306f64e312b581766351c07af79c72fcb1cd25147157fdc2f8ad76de9a3fb6a",
                    "type": "package",
                    "name": "",
                    "logo": ""
                },
                {
                    "address": "0x91bfbc386a41afcfd9b2533058d7e915a1d3829089cc268ff4333d54d6339ca1",
                    "type": "package",
                    "name": "Turbos",
                    "logo": "https://strapi-dev.scand.app/uploads/Turbos_Finance_Logo_35762dc0c3.jpg"
                },
                {
                    "address": "0x1fb0c0a6790860fc83c8f26f6fa089868ad94de9468348f98dfb4cdf89a53777",
                    "type": "account",
                    "name": "",
                    "logo": ""
                }
            ],
            "gas_fee": 0.020458112,
            "status": "success",
            "sender": "0xe9008ec0faa85024b357ebb7aa80cfc081ecf5a77bca299e5b365c627f1bb466",
            "events": [
                {
                    "action": "swap",
                    "coin_ins": [
                        {
                            "type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
                            "symbol": "USDC",
                            "amount": 3.068486
                        }
                    ],
                    "coin_outs": [
                        {
                            "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                            "symbol": "SUI",
                            "amount": 0.999695938
                        }
                    ],
                    "protocol": "cetus-clmm"
                },
                {
                    "action": "swap",
                    "coin_ins": [
                        {
                            "type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
                            "symbol": "SUI",
                            "amount": 0.999695938
                        }
                    ],
                    "coin_outs": [
                        {
                            "type": "0xcb8fc6858b4d600611cb783a65459695711b8aaca0e949ef5aa1268d1e32f786::suimon::SUIMON",
                            "symbol": "SUIMON",
                            "amount": 2431.739058641
                        }
                    ],
                    "protocol": "turbos-clmm"
                }
            ]
        }
    ],
    "nextPageCursor": "DeeZVSaC234MfhM62wg6ZPTs7yJnRjAfSTZvVNxc95Lx"
}
```

#### Response when no data is available

```json
{
    "data": [],
    "nextPageCursor": null
}
```

***

> **See also:** [Environment Setup](/docs.noodles.fi/environment-setup/environment.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://noodles-finance.gitbook.io/docs.noodles.fi/accounts/tx-history.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.