Token Transactions API

The token transactions API fetches the list of all transactions in wallet address

Our Bank statements often let us understand the financial positions of a bank account. Similarly for a Crypto wallet , the transactions gives the wallet holder a detailed analysis of the inbound and out bound transfers thereby keeping the wallet apprised of all the happenings in their wallet.

Unmarshal Transaction APIs are smart enough to differentiate the kind of operation a particular transaction was made for. It will let a user understand if the transaction was was for a send or receive or the amount was staked or un-staked , or if the transactions was for adding or removing liquidity .

get
Get token Transactions

https://stg-api.unmarshal.io/v1/{chain}/address/{address}/transactions?page=1&pageSize=2
Sample API : https://stg-api.unmarshal.io/v1/ethereum/address/ 0xb13943b4CC5B8F03A2e2872842C7E4118abdAe6F/transactions?page=1&pageSize=2&auth_key=VGVtcEtleQ%3D%3D
Request
Response
Request
Path Parameters
Page
optional
string
Can be added to fetch the desired page number
page size
optional
string
Can be added to for number of records to be displayed per page
Chain
required
string
Users will be able to fetch data on Ethereum Chain, Binance Smart Chain , Polygon and many more. The various request parameters for chain will be ethereum/bsc/matic/polkadot/stafi/algorand/heco/edgeware/ ziliqa/polkadot
address
required
string
Any Valid Address or ENS
Query Parameters
auth_key
optional
string
test Key - VGVtcEtleQ==
Response
200: OK
page : gives the page number of the response total_pages : overall count of the pages in which the result is returned items_on_page : number of items on the current page usually the per page value. total_txs : the total count of transactions on this wallet address on this chain id : transaction hash of the particular transaction from : the from address where the transaction initiated to : the address to on which the transaction was completed fee : the fee paid in the chain's base token date : timestamp of the transaction status : current status of the transaction whether the transaction completed or failed or pending type : the kind of transaction it is .. Whether it was Send, received, Staked , Unstaked, Swap, Mint, Burn, Contract Execution,Approve. Value : amount of tokens that were transferred in this transaction description : Custom description that describes the transaction to the user.
{
"page": 1,
"total_pages": 3,
"items_on_page": 20,
"total_txs": 48,
"transactions": [
{
"id": "0x5d6eacde36a50219b571ce03b3960c4a5af3f38e42230ced3c4bda289e553bdc",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0x283Af0B28c62C092C9727F1Ee09c02CA627EB7F5",
"fee": "4321920000000000",
"date": 1626173177,
"status": "completed",
"type": "send",
"value": "8130964787092602",
"description": "Sent 0.0081 ETH",
"sent": [
{
"name": "Ethereum",
"symbol": "ETH",
"token_id": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18,
"value": "8130964787092602",
"logo_url": "https://assets.unmarshal.io/tokens/0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee.png",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0x283Af0B28c62C092C9727F1Ee09c02CA627EB7F5"
}
]
},
{
"id": "0xddce618f5f00a5b0c857b5395ab5094cf097cf4be297f7be1705b56f60d50d58",
"from": "0x986a2fCa9eDa0e06fBf7839B89BfC006eE2a23Dd",
"to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"fee": "629387850000000",
"date": 1626025576,
"status": "completed",
"type": "receive",
"value": "0",
"description": "Received 72.4438 USDT",
"received": [
{
"name": "Tether USD",
"symbol": "USDT",
"token_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"decimals": 6,
"value": "72443800",
"logo_url": "https://assets.unmarshal.io/tokens/0xdAC17F958D2ee523a2206206994597C13D831ec7.png",
"from": "0x986a2fCa9eDa0e06fBf7839B89BfC006eE2a23Dd",
"to": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A"
}
]
},
{
"id": "0x2c9df3375b83569c19c727011385810dd2fe5956afd7a5bed51c9f52a3caf7e8",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
"fee": "2657130000000000",
"date": 1626024204,
"status": "completed",
"type": "swap",
"value": "0",
"description": "Swapped 2.3822 UNI-V2 for 115.1095 MARSH and 0.0827 WETH ",
"received": [
{
"name": "UnmarshalToken",
"symbol": "MARSH",
"token_id": "0x5a666c7d92E5fA7Edcb6390E4efD6d0CDd69cF37",
"decimals": 18,
"value": "115109532121156469050",
"logo_url": "https://assets.unmarshal.io/tokens/0x5a666c7d92E5fA7Edcb6390E4efD6d0CDd69cF37.png",
"from": "0x9c5DE3Ad97B95A0dA09FD0dE84c347DB450cd75c",
"to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
},
{
"name": "Wrapped Ether",
"symbol": "WETH",
"token_id": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"decimals": 18,
"value": "82732412252129149",
"logo_url": "https://assets.unmarshal.io/tokens/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2.png",
"from": "0x9c5DE3Ad97B95A0dA09FD0dE84c347DB450cd75c",
"to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D"
}
],
{
"id": "0xbd1dff82e488641ef3b5a2513c1103b88ce85ba86df700c67a15d825b4c2e77f",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0xB796e2266C055F7d46ee58a116b53c73127393EF",
"fee": "1799392000000000",
"date": 1626023850,
"status": "completed",
"type": "unstake",
"value": "0",
"description": "Unstaked 2.3822 UNI-V2 and 447.0118 GUM ",
"received": [
{
"name": "Uniswap V2",
"symbol": "UNI-V2",
"token_id": "0x9c5DE3Ad97B95A0dA09FD0dE84c347DB450cd75c",
"decimals": 18,
"value": "2382203000000000000",
"logo_url": "https://assets.unmarshal.io/tokens/0x9c5DE3Ad97B95A0dA09FD0dE84c347DB450cd75c.png",
"from": "0xB796e2266C055F7d46ee58a116b53c73127393EF",
"to": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A"
},
{
"name": "GourmetGalaxy",
"symbol": "GUM",
"token_id": "0x4f5fa8f2d12e5eB780f6082Dd656C565C48E0f24",
"decimals": 18,
"value": "447011757899112633714",
"logo_url": "https://assets.unmarshal.io/tokens/0x4f5fa8f2d12e5eB780f6082Dd656C565C48E0f24.png",
"from": "0xB796e2266C055F7d46ee58a116b53c73127393EF",
"to": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A"
}
]
},
{
"id": "0x7f8c3ba0ee657a0b8722724f34478444a0918f2630ccfb96cf3cbf322d967db5",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
"fee": "6307395000000000",
"date": 1625471897,
"status": "completed",
"type": "contract_execution",
"value": "52659961825981309",
"description": "Contract execution",
"sent": [
{
"name": "Tether USD",
"symbol": "USDT",
"token_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"decimals": 6,
"value": "250000000",
"logo_url": "https://assets.unmarshal.io/tokens/0xdAC17F958D2ee523a2206206994597C13D831ec7.png",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0x4e68Ccd3E89f51C3074ca5072bbAC773960dFa36"
}
]
},
{
"id": "0x17153a414cfcf981e9855e094c2c74727e53dff0e21c3d2c94f3ac1939ea8555",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"fee": "684558000000000",
"date": 1625471736,
"status": "completed",
"type": "approve",
"value": "0",
"description": "Approved USDT",
"sent": [
{
"name": "USDT",
"symbol": "USDT",
"token_id": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"decimals": 18,
"value": "",
"logo_url": "https://assets.unmarshal.io/tokens/0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee.png",
"from": "0xAc09b78E7Fa259d3b914d74052a54EE460240f5A",
"to": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
}
]
},
}
]
}