Account's Tx History

Retrieve the transaction history for a specific wallet address. Just provided with private partners. Please consider to use this API with care.

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

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

{
    "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

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

---

See also: Environment Setup