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 token Transactions

GET 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

Path Parameters

Name	Type	Description
Page	string	Can be added to fetch the desired page number
page size	string	Can be added to for number of records to be displayed per page
Chain	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/solana
address	string	Any Valid Address or ENS

Query Parameters

Name	Type	Description
auth_key	string	test Key - VGVtcEtleQ==

200 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"
        }
      ]
    },
    }
  ]
}