Transactions Response Fields

This page describes the fields of the response provided by the User Transaction endpoints

The Transactions end-points below will be deprecated by end Q1 2024. Please refer to the NEW User Pre-Classified Transactions end-points, available here.

ParameterTypeDescription

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:

Deposited, Withdrew, Borrowed, Repaid, Liquidation, Claim, Exchange, Send, Receive, Transfer, Distribute Rewards, Migration, Harvest, ...

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

Last updated