Transactions Response Fields

This page describes the fields of the Transaction object

Transactions

The User Transactions endpoints return a list of Transactions objects representing all the on-chain Transactions which the input User was involved into.

Each Transaction object contains the following parameters:

Transaction identification

Parameter Type Description

Parameter	Type	Description
`block`	`number`	Block number; applies for P&L supported protocols
`chain`	`string`	Blockchain identification, corresponds to the '`id`' parameter returned by the 'getSupportedChains' endpoint
`hash`	`string`	Transaction hash
`id`	`string`	Merlin internal id of the transaction
`order`	`number`	Internal use: combined information about block and log index, used for detailed pagination features
`from`	`string`	Wallet or smart contract address initiating the overall transaction
`to`	`string`	Wallet or smart contract address recipient
`timeStamp`	`number`	Timestamp of the transaction (Unix time)
`txClassification`	`string`	Automatic transaction classification types: DeFi: LP Deposit, LP Withdraw, Staking Deposit, Staking Withdraw, Staking Rewards, Lend Deposit, Lend Withdraw, Borrow, Repay, Liquidation, Deposit, Withdraw, Collect Interest, Collect Reward, Exchange, NFT Exchange, Wrap, Unwrap Transfers, which require mostly user intervention for classification: *Income, Expense Out, Expense In, Receive Donation, Send Donation, Spouse Transfer, Transfer Out, Transfer In, Bridge Out, Bridge In* Other miscellaneous: Airdrop, ICO IDO, Mint, Lost Stolen, Scam, Other, Exclude More details here *classification made by the user via MERLIN web APP and available within the associated CSV export data; not available in the endpoint response data
`txType`	`string`	Type of movement, possible values: for P&L supported protocols & Transactions supported chains: Deposited, Withdrew, Borrowed, Repaid, Liquidation, Claim, Exchange, Send, Receive, Wrap, Unwrap, Bridge In, Bridge Out, Distribute Rewards, Migration, Harvest, Airdrop, Mint, Burn for other DeFi supported protocols & chains: txType indicates the smart contract function name More details here
`txAction`	`string`	Type of DeFi investment: P&L supported protocols & Transactions supported chains: Liquidity Pool, Lending, Staked, Farming, Leveraged Farming, Yield, Locked, Wrap, Bridge, Transfer (for wallet to wallet), NFT (for NFT related transactions), Vesting, Options Seller, Options Buyer, Insurance Seller, Insurance Buyer, Investment, Governance for other DeFi supported protocols & chains: unknown empty value More details here
`contractName`	`string`	If interaction with smart contract, the smart contract name Applies for Transactions supported chains, more details here
`functionName`	`string`	If interaction with smart contract, smart contract function name (method name) Applies for Transactions supported chains, more details here
`protocol`	`string`	If movement wallet <> protocol, name of the DeFi protocol name. Corresponds to the '`name`" parameter returned by the 'getSupportedProtocolsList" endpoint. Returns 'wallet' value for wallet to wallet transactions, not involving a protocol Applies for Transactions supported chains, more details here
`walletToWallet`	`boolean`	Indicates movement between wallets Applies for Transactions supported chains, more details here
`blacklisted`	`boolean`	Potential scam token / contract
`txFee`	`number`	Transaction fee in native token amount. Please refer to 'getAdvTransactionSupportedChains' endpoint for native token reference, '`currency`' parameter. Applies for Transactions supported chains, more details here
`txFeeUsd`	`number`	USD valuation of the transaction fee Applies for Transactions supported chains, more details here
`userPaidFees`	`bool`	Indicates if the transaction fees are supported by the user Applies for Transactions supported chains, more details here
`successful`	`boolean`	Indicates if the transaction was realized, and balances were actually transferred in / out; '`false`' value indicates a reverted/failed transaction, transaction `balances` object is empty

block

number

Block number; applies for P&L supported protocols

chain

string

Blockchain identification, corresponds to the 'id' parameter returned by the 'getSupportedChains' endpoint

hash

string

Transaction hash

id

string

Merlin internal id of the transaction

order

number

Internal use: combined information about block and log index, used for detailed pagination features

from

string

Wallet or smart contract address initiating the overall transaction

to

string

Wallet or smart contract address recipient

timeStamp

number

Timestamp of the transaction (Unix time)

txClassification

string

Automatic transaction classification types:

DeFi: LP Deposit, LP Withdraw, Staking Deposit, Staking Withdraw, Staking Rewards, Lend Deposit, Lend Withdraw, Borrow, Repay, Liquidation, Deposit, Withdraw, Collect Interest, Collect Reward, Exchange, NFT Exchange, Wrap, Unwrap

Transfers, which require mostly user intervention for classification: Income*, Expense Out*, Expense In*, Receive Donation*, Send Donation*, Spouse Transfer*, Transfer Out*, Transfer In*, Bridge Out, Bridge In

Other miscellaneous: Airdrop, ICO IDO*, Mint*, Lost Stolen*, Scam*, Other*, Exclude*

More details here

*classification made by the user via MERLIN web APP and available within the associated CSV export data; not available in the endpoint response data

txType

string

Type of movement, possible values:

for P&L supported protocols & Transactions supported chains: Deposited, Withdrew, Borrowed, Repaid, Liquidation, Claim, Exchange, Send, Receive, Wrap, Unwrap, Bridge In, Bridge Out, Distribute Rewards, Migration, Harvest, Airdrop, Mint, Burn

for other DeFi supported protocols & chains: txType indicates the smart contract function name

More details here

txAction

string

Type of DeFi investment:

P&L supported protocols & Transactions supported chains: Liquidity Pool, Lending, Staked, Farming, Leveraged Farming, Yield, Locked, Wrap, Bridge, Transfer (for wallet to wallet), NFT (for NFT related transactions), Vesting, Options Seller, Options Buyer, Insurance Seller, Insurance Buyer, Investment, Governance
for other DeFi supported protocols & chains: unknown empty value

More details here

contractName

string

If interaction with smart contract, the smart contract name

Applies for Transactions supported chains, more details here

functionName

string

If interaction with smart contract, smart contract function name (method name)

Applies for Transactions supported chains, more details here

protocol

string

If movement wallet <> protocol, name of the DeFi protocol name. Corresponds to the 'name" parameter returned by the 'getSupportedProtocolsList" endpoint. Returns 'wallet' value for wallet to wallet transactions, not involving a protocol

Applies for Transactions supported chains, more details here

walletToWallet

boolean

Indicates movement between wallets

Applies for Transactions supported chains, more details here

blacklisted

boolean

Potential scam token / contract

txFee

number

Transaction fee in native token amount. Please refer to 'getAdvTransactionSupportedChains' endpoint for native token reference, 'currency' parameter.

Applies for Transactions supported chains, more details here

txFeeUsd

number

USD valuation of the transaction fee

Applies for Transactions supported chains, more details here

userPaidFees

bool

Indicates if the transaction fees are supported by the user

Applies for Transactions supported chains, more details here

successful

boolean

Indicates if the transaction was realized, and balances were actually transferred in / out; 'false' value indicates a reverted/failed transaction, transaction balances object is empty

**Balances for Solana Transactions: Rent Changes on Solana

Prior to 2023, Solana accounts were subject to rent, where SOL would periodically be deducted from accounts with stored data. However, since 2023, this practice has ceased, and instead, accounts must maintain a rent-exempt status by holding a minimum SOL balance (approximately 0.008 SOL).

When checking wallet balances, particularly those active before 2023, it's important to note that differences between transaction-based computed balances and blockchain balances may occur due to the former rent deductions. Please consider this when reconciling balances.

Asset(s)s moved - inner movement(s)

Parameter Type Description

Parameter	Type	Description
`balances**`	`object`	List of asset movements (inner transaction movements)
--`from`	`string`	Inner movement initiator: wallet or smart contract address
--`to`	`string`	Inner movement beneficiary: wallet or smart contract address
--`balance`	`number`	Amount of tokens moved: - (negative) value implies outgoing flow + (positive) value implies incoming flow
--`balanceUSD`	`number`	USD valuation of the amount of tokens moved
--`tokenAddress`	`string`	Token address
--`tokenSymbol`	`string`	Token symbol
--`tokenName`	`string`	Token name
--`tokenDecimals`	`number`	Token decimals
--`tokenLogo`	`string`	URL Link to the token logo (png picto)
--`standard`	`string`	Token standard: ERC20, ERC721, ERC1155, INTERNAL (blockchain native token), SPL-TOKEN
--`nftDetails`	`object`	If the moved asset is an NFT, further transaction details
--/--`floorPrice`	`number`	USD floor price
--/--`content`	`string`	URL link to NFT content
--/--`detailUrl`	`string`	URL link to NFT
--/--`payToken`	`object`	Price of the NFT, for the current sale transaction
--/--/--`amount`	`number`	Price in token balance
--/--/--`address`	`string`	Token address
--/--/--`timestamp`	`number`
--/--`innerId`	`number`	NFT ID within the collection
--/--`action`	`string`	Type of NFT transaction, possible values: PURCHASE: NFT is sold, buyer and seller involved, current user is buyer if+ positive balance, or seller if - negative balance MINT: NFT is minted TRANSFER: NFT is simply transferred (no mint nor sale detected)
--/--`salesHistory`	`object`	NFT sales history, 2 transactions provided: current and first sale
--/--/--`marketplace`	`string`	Name of the marketplace which processed the sale. Possible values: "seaport", "wyvern", "cryptopunks", "x2y2", "looksrare", "blur"
--/--/--`marketplaceAddress`	`string`	Address of the marketplace which processed the sale
--/--/--`buyerAddress`	`string`	NFT buyer user address: wallet or smart contract
--/--/--`sellerAddress`	`string`	NFT seller user address: wallet or smart contract
--/--/--`sellerFee`	`object`	NFT price breakdown > seller fee: amount received by the seller
--/--/--/--`amount`	`number`	Amount received by the seller, token amount
--/--/--/--`tokenAddress`	`string`	Address of the paid token
--/--/--/--`symbol`	`string`	Short symbol of the paid token
--/--/--/--`decimals`	`number`	Number of decimals to be applied to the token `amount` value
--/--/--`protocolFee`	`object`	NFT price breakdown > protocol fee: marketplace share in the sale
--/--/--/--`amount`	`number`	Amount received by the marketplace, token amount
--/--/--/--`tokenAddress`	`string`	Address of the paid token
--/--/--/--`symbol`	`string`	Short symbol of the paid token
--/--/--/--`decimals`	`number`	Number of decimals to be applied to the token `amount` value
--/--/--`royaltyFee`	`object`	NFT price breakdown > protocol fee: marketplace share in the sale
--/--/--/--`amount`	`number`	Amount received by the NFT creator, token amount
--/--/--/--`tokenAddress`	`string`	Address of the paid token
--/--/--/--`symbol`	`string`	Short symbol of the paid token
--/--/--/--`decimals`	`number`	Number of decimals to be applied to the token `amount` value
--/--/--`blockNumber`	`number`	Blockchain block number containing this NFT sale transaction
--/--/--`transactionHash`	`string`	Hash of this NFT sale transaction

balances**

object

List of asset movements (inner transaction movements)

--from

string

Inner movement initiator: wallet or smart contract address

--to

string

Inner movement beneficiary: wallet or smart contract address

--balance

number

Amount of tokens moved:

- (negative) value implies outgoing flow

+ (positive) value implies incoming flow

--balanceUSD

number

USD valuation of the amount of tokens moved

--tokenAddress

string

Token address

--tokenSymbol

string

Token symbol

--tokenName

string

Token name

--tokenDecimals

number

Token decimals

--tokenLogo

string

URL Link to the token logo (png picto)

--standard

string

Token standard: ERC20, ERC721, ERC1155, INTERNAL (blockchain native token), SPL-TOKEN

--nftDetails

object

If the moved asset is an NFT, further transaction details

--/--floorPrice

number

USD floor price

--/--content

string

URL link to NFT content

--/--detailUrl

string

URL link to NFT

--/--payToken

object

Price of the NFT, for the current sale transaction

--/--/--amount

number

Price in token balance

--/--/--address

string

Token address

--/--/--timestamp

number

--/--innerId

number

NFT ID within the collection

--/--action

string

Type of NFT transaction, possible values:

PURCHASE: NFT is sold, buyer and seller involved, current user is buyer if+ positive balance, or seller if - negative balance
MINT: NFT is minted
TRANSFER: NFT is simply transferred (no mint nor sale detected)

--/--salesHistory

object

NFT sales history, 2 transactions provided: current and first sale

--/--/--marketplace

string

Name of the marketplace which processed the sale. Possible values: "seaport", "wyvern", "cryptopunks", "x2y2", "looksrare", "blur"

--/--/--marketplaceAddress

string

Address of the marketplace which processed the sale

--/--/--buyerAddress

string

NFT buyer user address: wallet or smart contract

--/--/--sellerAddress

string

NFT seller user address: wallet or smart contract

--/--/--sellerFee

object

NFT price breakdown > seller fee: amount received by the seller

--/--/--/--amount

number

Amount received by the seller, token amount

--/--/--/--tokenAddress

string

Address of the paid token

--/--/--/--symbol

string

Short symbol of the paid token

--/--/--/--decimals

number

Number of decimals to be applied to the token amount value

--/--/--protocolFee

object

NFT price breakdown > protocol fee: marketplace share in the sale

--/--/--/--amount

number

Amount received by the marketplace, token amount

--/--/--/--tokenAddress

string

Address of the paid token

--/--/--/--symbol

string

Short symbol of the paid token

--/--/--/--decimals

number

Number of decimals to be applied to the token amount value

--/--/--royaltyFee

object

NFT price breakdown > protocol fee: marketplace share in the sale

--/--/--/--amount

number

Amount received by the NFT creator, token amount

--/--/--/--tokenAddress

string

Address of the paid token

--/--/--/--symbol

string

Short symbol of the paid token

--/--/--/--decimals

number

Number of decimals to be applied to the token amount value

--/--/--blockNumber

number

Blockchain block number containing this NFT sale transaction

--/--/--transactionHash

string

Hash of this NFT sale transaction

P&L for DeFi Transactions

Parameter Type Description

Parameter	Type	Description
`pnlUsd`	`number`	Applies for DeFi investment transactions USD valuation of the P&L of this specific transaction, which includes Yields, Tx Fees and asset price fluctuation Applies for P&L supported protocols, more details here
`positionYield`	`object`	Applies for DeFi investment transactions Tokens received as yield when the received token is rebasable Applies for P&L supported protocols, more details here
--`tokenAddress`	`string`	Token address
--`balance`	`number`	Amount of tokens received as Yield
--`balanceUSD`	`number`	USD valuation of the amount of tokens received as Yield
--`tokenSymbol`	`string`	Token symbol
--`tokenDecimals`	`number`	Token decimals
`yields`	`object`	Applies for DeFi investment transactions Tokens received as Yield for non rebasable position tokens Applies for P&L supported protocols, more details here
--`balance`	`number`	Amount of tokens received as Yield
--`balanceUSD`	`number`	USD valuation of the amount of tokens received as Yield
--`tokenSymbol`	`string`	Token symbol
--`tokenDecimals`	`number`	Token decimals
`yieldUSD`	`number`	Applies for DeFi investment transactions USD valuation of the transaction's Yield Applies for P&L supported protocols, more details here
`slippageUSD`	`number`	Applies for DeFi swaps (txType Exchange) USD valuation of the slippage, applies for swap transactions Applies for P&L supported protocols, more details here
`active`	`boolean`	Applies for DeFi investment transactions True if the DeFi position associated to this transaction (eg deposit) is still active (open) and therefore generating Yields Applies for P&L supported protocols, more details here

pnlUsd

number

Applies for DeFi investment transactions

USD valuation of the P&L of this specific transaction, which includes Yields, Tx Fees and asset price fluctuation

Applies for P&L supported protocols, more details here

positionYield

object

Applies for DeFi investment transactions

Tokens received as yield when the received token is rebasable

Applies for P&L supported protocols, more details here

--tokenAddress

string

Token address

--balance

number

Amount of tokens received as Yield

--balanceUSD

number

USD valuation of the amount of tokens received as Yield

--tokenSymbol

string

Token symbol

--tokenDecimals

number

Token decimals

yields

object

Applies for DeFi investment transactions

Tokens received as Yield for non rebasable position tokens

Applies for P&L supported protocols, more details here

--balance

number

Amount of tokens received as Yield

--balanceUSD

number

USD valuation of the amount of tokens received as Yield

--tokenSymbol

string

Token symbol

--tokenDecimals

number

Token decimals

yieldUSD

number

Applies for DeFi investment transactions

USD valuation of the transaction's Yield

Applies for P&L supported protocols, more details here

slippageUSD

number

Applies for DeFi swaps (txType Exchange)

USD valuation of the slippage, applies for swap transactions

Applies for P&L supported protocols, more details here

active

boolean

Applies for DeFi investment transactions

True if the DeFi position associated to this transaction (eg deposit) is still active (open) and therefore generating Yields

Applies for P&L supported protocols, more details here

Transactions Overview

The User Transactions Overview endpoint returns a list of chains the specific user is active on, and the number of transactions initiated by the user on those chains:

Parameter Type

Parameter	Type
`wallet`	`string`	The user wallet address for which the response is provided for
`nbOfChains`	`number`	The number of chains the user is active on Applies for all supported chains, please refer to the getSupportedChains endpoint
`nbOfTransactions`	`number`	The overall number of transactions initiated by the user on the chains it is active on The nb of transactions initiated by the user is not the exhaustive nb of transactions related to that user; does not include internal transfers or other transactions not initiated by the user
`creationTimestamp`	`number`	Date when the wallet was created, Unix timestamp format
`overview`	`list of objects`	List of objects for each chain the user is active on
--`chainId`	string	Chain Id, please refer to the getSupportedChains endpoint for id format
--`creationTimestamp`	number	Date when the wallet was created on this chain, Unix timestamp format
--`nbOfTransactions`	number	Number of transactions initiated by the user on this chain The nb of transactions initiated by the user is not the exhaustive nb of transactions related to that user; does not include internal transfers or other transactions not initiated by the user

wallet

string

The user wallet address for which the response is provided for

nbOfChains

number

The number of chains the user is active on Applies for all supported chains, please refer to the getSupportedChains endpoint

nbOfTransactions

number

The overall number of transactions initiated by the user on the chains it is active on The nb of transactions initiated by the user is not the exhaustive nb of transactions related to that user; does not include internal transfers or other transactions not initiated by the user

creationTimestamp

number

Date when the wallet was created, Unix timestamp format

overview

list of objects

List of objects for each chain the user is active on

--chainId

string

Chain Id, please refer to the getSupportedChains endpoint for id format

--creationTimestamp

number

Date when the wallet was created on this chain, Unix timestamp format

--nbOfTransactions

number

Number of transactions initiated by the user on this chain The nb of transactions initiated by the user is not the exhaustive nb of transactions related to that user; does not include internal transfers or other transactions not initiated by the user

PreviousTransactions End-points NextOLD - User Transactions

Last updated 12 days ago