Transactions Response Fields

This page describes the fields of the response provided by the User Transaction endpoints
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 'getAllSupportedChains' endpoint
protocol
string
Protocol name, corresponds to the 'name" parameter returned by the 'getSupportedProtocolsList" endpoint
hash
string
Transaction hash
id
string
Merlin internal id of the transaction
order
number
Combined information about block and log index, used for detailed pagination features
from
string
Wallet or smart contract address
to
string
Wallet or smart contract address
timeStamp
number
Timestamp of the transaction (unix time)
txType
string
Type of transaction, possible values:
Deposit, Withdraw, Borrow, Repay, Liquidation, Collect, Exchange, Send, Receive, Transfer, Receive Rewards, Migration, ...
txAction
string
Type of DeFi investment:
for DeFi supported protocols: unknown;
for P&L supported protocols: Liquidity Pool, Lending, Liquid Staking, Farming, Leveraged Farming, Yield, Locked, Vesting, Options Seller, Options Buyer, Insurance Seller, Insurance Buyer, Investment, Governance
contractName
string
If interaction with smart contract, the smart contract name
functionName
string
if interaction with smart contract, smart contract function name (method name)
txFee
number
Transaction fee in wei (gas price * gas used)
txFeeUsd
number
USD valuation of the transaction fee
balances
object
List of assets moved
--balance
number
Amount of tokens moved
--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
Link to the token logo (png picto)
pnlUsd
number
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 only, "...withPnl..." enpoints only
positionYield
object
Tokens received as yield when the received token is rebasable
Applies for P&L supported protocols only, "...withPnl..." enpoints only
--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
Tokens received as Yield for non rebasable position tokens
Applies for P&L supported protocols only, "...withPnl..." enpoints only
--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
USD valuation of the transaction's Yield
Applies for P&L supported protocols only, "...withPnl..." enpoints only
slippageUSD
number
USD valuation of the slippage, applies for swap transactions
active
boolean
True if the DeFi position associated to this transaction (eg deposit) is still active (open) and therefore generating Yields