chain

Get User Transactions

Retrieves historical transaction details for one or more user addresses over a defined block range, including both simple native transfers and complex contract interactions. For each transaction, the response provides the hash, nonce, sender/receiver addresses, value, gas details, block info, and any ERC20/NFT/native token transfers, along with summaries, categorization (send, receive, etc.), and pagination via a next-page token.

💡 Compute Unit Value: 245 (Fixed)

get/defi/v1/chain/getusertransactions

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/chain/getusertransactions
Auth
API key in header X-API-Key

Query parameters

chainId'43115' | '43116' | '43114' | '1' | '56' | '137' | '250' | '10' | '42161' | '25' | '8453' | '1100' | '1101' | '900' | '1500' | '1501' | '1600' | '1601' | '1700' | '1701' | '1800' | '1400'

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

Example:43115

chainSymbolstring

The abbreviated chain name for queries or transactions.

Example:ETH

addressstring required

The public address of the user.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

endBlockstring

The ending block number from which to get the transactions. By default, the current block.

Example:100010

startBlockstring

The starting block number from which to get the transactions. By default, the Genesis block.

Example:100000

pageTokenstring

The page cursor present at the top to fetch the next page.

Example:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYWdlIjoxLCJjb250cmFjdEFkZHJlc3MiOiIweGZhZThlNjRjZGRlNzM1NTBlN2Q3ZjA0Njk1NTdhMzNhNDE3YjI4NjgiLCJjb250cmFjdFR5cGUiOiJlcmMyMCIsImFwcHJvdmVyQWRkcmVzcyI6IjB4NjVhOGYwN2JkOWE4NTk4ZTFiNWI2YzBhODhmNDc3OWRiYzA3NzY3NSIsInNwZW5kZXJBZGRyZXNzIjoiMHgxMTExMTExMjU0ZmI2YzQ0YmFjMGJlZDI4NTRlNzZmOTA2NDMwOTdkIiwiaWF0IjoxNzMzMzkzODE2fQ.y7FANxpXgtdgk83CIqPHHk2jutj1NZrueTu4XR39jnk

sortOrder'desc' | 'asc'

The transaction sorting order. 'asc' or 'desc'. By default, desc.

Example:desc

pageSizestring

The number of transactions to fetch per page. By default, 30. Max: 100.

Example:10

fromTimestampstring

The start date (in seconds or date string) from which to get the transactions. If 'startBlock' is also provided, 'startBlock' will be used.

Example:1741869257

toTimestampstring

The end date (in seconds or date string) from which to get the transactions. If 'endBlock' is also provided, 'endBlock' will be used.

Example:1741969257

limitstring

Maximum number of transactions in response. Maximum: 5.

Example:10

beforeBlockstring

The block number before which the user wants the transactions.

Example:100010

afterBlockstring

The block number after which the user wants the transactions.

Example:100000

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "nextPageToken": "eyJhbGciOiJIUzI1NiJ9.eyJ0YWJsZUluZGV4IjowLCJsYXN0RXZhbHVhdGVkS2V5Ijp7IndhbGxldEFkZHJlc3MiOiIweDk1MjIyMjkwZGQ3Mjc4YWEzZGRkMzg5Y2MxZTFkMTY1Y2M0YmFmZTUiLCJ0aW1lc3RhbXBfYmxvY2tOdW1iZXJfdHhJbmRleCI6IjAwMDAwMDE3MzI1NzkxNjMwMDAyMTI2ODE5OTAwMDAxIn0sInBhZ2VOdW1iZXIiOjAsImtleUNvbmRpdGlvbkV4cHJlc3Npb24iOnsid2FsbGV0QWRkcmVzcyI6eyJlcSI6IjB4OTUyMjIyOTBkZDcyNzhhYTNkZGQzODljYzFlMWQxNjVjYzRiYWZlNSJ9LCJ0aW1lc3RhbXBfYmxvY2tOdW1iZXJfdHhJbmRleCI6eyJiZXR3ZWVuIjpbIjAwMDAwMDE3MzI0OTI3OTkwMDAwMDAwMDAwMDAwMDAwIiwiMDAwMDAwMTczMjU3OTE5OTAwMDAwMDAwMDAwOTk5OTkiXX19LCJsaW1pdCI6IjUiLCJvcmRlciI6ImRlc2NlbmRpbmcifQ.A8XTqltMTV2l6qit4DIvVEPrtZKDyqHwSa3kjg8_zio",
    "pageSize": "5",
    "transactions": [
      {
        "hash": "0x4357e50aa43cac717c971e4f86a6689fd621515559ab07919a21184e500bbdb6",
        "nonce": "1706902",
        "transaction_index": "61",
        "from_address_entity": null,
        "from_address_entity_logo": null,
        "from_address": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
        "from_address_label": "beaverbuild",
        "to_address_entity": null,
        "to_address_entity_logo": null,
        "to_address": "0x13f2241aa64bb6da2b74553fa9e12b713b74f334",
        "to_address_label": null,
        "value": "65645477106837944",
        "gas": "21000",
        "gas_price": "6284009466",
        "receipt_cumulative_gas_used": "13777624",
        "receipt_gas_used": "21000",
        "receipt_contract_address": null,
        "receipt_status": "1",
        "block_timestamp": "2024-11-25T23:59:23.000Z",
        "block_number": "21268199",
        "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
        "transaction_fee": "0.000131964198786",
        "method_label": null,
        "nft_transfers": [],
        "erc20_transfers": [],
        "native_transfers": [
          {
            "from_address_entity": null,
            "from_address_entity_logo": null,
            "from_address": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "from_address_label": "beaverbuild",
            "to_address_entity": null,
            "to_address_entity_logo": null,
            "to_address": "0x13f2241aa64bb6da2b74553fa9e12b713b74f334",
            "to_address_label": null,
            "value": "65645477106837944",
            "value_formatted": "0.06564547710683795",
            "direction": "send",
            "internal_transaction": false,
            "token_symbol": "ETH"
          }
        ],
        "summary": "Sent 0.06564 ETH to 0x13...f334",
        "possible_spam": false,
        "category": "send",
        "internal_transactions": []
      },
      {
        "hash": "0x85d86ae6a47ef52184ee1849ffc438bf47a7a3f5059c04aac0c7a9da4815beb8",
        "nonce": "1706901",
        "transaction_index": "10",
        "from_address_entity": null,
        "from_address_entity_logo": null,
        "from_address": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
        "from_address_label": "beaverbuild",
        "to_address_entity": null,
        "to_address_entity_logo": null,
        "to_address": "0xb7641d7b663d6cfc149c544883ef1692fea348a6",
        "to_address_label": null,
        "value": "81728592291360",
        "gas": "21000",
        "gas_price": "6284009466",
        "receipt_cumulative_gas_used": "2571406",
        "receipt_gas_used": "21000",
        "receipt_contract_address": null,
        "receipt_status": "1",
        "block_timestamp": "2024-11-25T23:59:23.000Z",
        "block_number": "21268199",
        "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
        "transaction_fee": "0.000131964198786",
        "method_label": null,
        "nft_transfers": [],
        "erc20_transfers": [],
        "native_transfers": [
          {
            "from_address_entity": null,
            "from_address_entity_logo": null,
            "from_address": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "from_address_label": "beaverbuild",
            "to_address_entity": null,
            "to_address_entity_logo": null,
            "to_address": "0xb7641d7b663d6cfc149c544883ef1692fea348a6",
            "to_address_label": null,
            "value": "81728592291360",
            "value_formatted": "0.00008172859229136",
            "direction": "send",
            "internal_transaction": false,
            "token_symbol": "ETH"
          }
        ],
        "summary": "Sent 0.00008172 ETH to 0xb7...48a6",
        "possible_spam": false,
        "category": "send",
        "internal_transactions": []
      },
      {
        "hash": "0x85ab1681dcb221869eaf62ba03642fbc76279c3364490ad30cf078b12e9ba75b",
        "nonce": "346",
        "transaction_index": "4",
        "from_address_entity": null,
        "from_address_entity_logo": null,
        "from_address": "0x86da51f66a5f4b170200f8cc6429856580541028",
        "from_address_label": null,
        "to_address_entity": null,
        "to_address_entity_logo": null,
        "to_address": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
        "to_address_label": null,
        "value": "0",
        "gas": "500000",
        "gas_price": "6315429513",
        "receipt_cumulative_gas_used": "1539105",
        "receipt_gas_used": "258878",
        "receipt_contract_address": null,
        "receipt_status": "1",
        "block_timestamp": "2024-11-25T23:59:23.000Z",
        "block_number": "21268199",
        "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
        "transaction_fee": "0.001634925761466414",
        "method_label": null,
        "nft_transfers": [],
        "erc20_transfers": [],
        "native_transfers": [],
        "summary": "Signed a transaction",
        "possible_spam": false,
        "category": "contract interaction",
        "internal_transactions": [
          {
            "transaction_hash": "0x85ab1681dcb221869eaf62ba03642fbc76279c3364490ad30cf078b12e9ba75b",
            "block_number": 21268199,
            "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
            "type": "CALL",
            "from": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "to": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "value": "3039388317129529",
            "gas": "2300",
            "gas_used": "0",
            "input": "0x",
            "output": "0x"
          },
          {
            "transaction_hash": "0x85ab1681dcb221869eaf62ba03642fbc76279c3364490ad30cf078b12e9ba75b",
            "block_number": 21268199,
            "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
            "type": "CALL",
            "from": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "to": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "value": "3039388317129529",
            "gas": "2300",
            "gas_used": "72",
            "input": "0x",
            "output": "0x"
          }
        ]
      },
      {
        "hash": "0xebba90e71f26c8a82b825527ab7eeefc1775697648499c7b1139b8225c9ac54d",
        "nonce": "273",
        "transaction_index": "2",
        "from_address_entity": null,
        "from_address_entity_logo": null,
        "from_address": "0xe17e026d3dc521154e773867b4e20577b32bdff9",
        "from_address_label": null,
        "to_address_entity": null,
        "to_address_entity_logo": null,
        "to_address": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
        "to_address_label": null,
        "value": "0",
        "gas": "500000",
        "gas_price": "6315429513",
        "receipt_cumulative_gas_used": "637296",
        "receipt_gas_used": "258836",
        "receipt_contract_address": null,
        "receipt_status": "1",
        "block_timestamp": "2024-11-25T23:59:23.000Z",
        "block_number": "21268199",
        "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
        "transaction_fee": "0.001634660513426868",
        "method_label": null,
        "nft_transfers": [],
        "erc20_transfers": [],
        "native_transfers": [],
        "summary": "Signed a transaction",
        "possible_spam": false,
        "category": "contract interaction",
        "internal_transactions": [
          {
            "transaction_hash": "0xebba90e71f26c8a82b825527ab7eeefc1775697648499c7b1139b8225c9ac54d",
            "block_number": 21268199,
            "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
            "type": "CALL",
            "from": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "to": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "value": "8393334440265254",
            "gas": "2300",
            "gas_used": "0",
            "input": "0x",
            "output": "0x"
          },
          {
            "transaction_hash": "0xebba90e71f26c8a82b825527ab7eeefc1775697648499c7b1139b8225c9ac54d",
            "block_number": 21268199,
            "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
            "type": "CALL",
            "from": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "to": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "value": "8393334440265254",
            "gas": "2300",
            "gas_used": "72",
            "input": "0x",
            "output": "0x"
          }
        ]
      },
      {
        "hash": "0x23a019479daf56c662517dca483614041f5b9608e7d872c087dbcf277f2da811",
        "nonce": "365",
        "transaction_index": "1",
        "from_address_entity": null,
        "from_address_entity_logo": null,
        "from_address": "0xedd538785fe8cd7ecfdc08b1a6b93925d741cf1b",
        "from_address_label": null,
        "to_address_entity": null,
        "to_address_entity_logo": null,
        "to_address": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
        "to_address_label": null,
        "value": "0",
        "gas": "500000",
        "gas_price": "6315429513",
        "receipt_cumulative_gas_used": "378460",
        "receipt_gas_used": "226858",
        "receipt_contract_address": null,
        "receipt_status": "1",
        "block_timestamp": "2024-11-25T23:59:23.000Z",
        "block_number": "21268199",
        "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
        "transaction_fee": "0.001432705708460154",
        "method_label": null,
        "nft_transfers": [],
        "erc20_transfers": [],
        "native_transfers": [
          {
            "from_address_entity": null,
            "from_address_entity_logo": null,
            "from_address": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "from_address_label": null,
            "to_address_entity": null,
            "to_address_entity_logo": null,
            "to_address": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "to_address_label": "beaverbuild",
            "value": "2606209353475460",
            "value_formatted": "0.00260620935347546",
            "direction": "receive",
            "internal_transaction": true,
            "token_symbol": "ETH"
          }
        ],
        "summary": "Received 0.002606 ETH from 0x81...ca60",
        "possible_spam": false,
        "category": "receive",
        "internal_transactions": [
          {
            "transaction_hash": "0x23a019479daf56c662517dca483614041f5b9608e7d872c087dbcf277f2da811",
            "block_number": 21268199,
            "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
            "type": "CALL",
            "from": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "to": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
            "value": "2606209353475460",
            "gas": "2300",
            "gas_used": "0",
            "input": "0x",
            "output": "0x"
          },
          {
            "transaction_hash": "0x23a019479daf56c662517dca483614041f5b9608e7d872c087dbcf277f2da811",
            "block_number": 21268199,
            "block_hash": "0xebef1670529602e29a4f56802b5dbf9fb58d04ffec9295ea262c6d881ee35534",
            "type": "CALL",
            "from": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "to": "0x817648d73fd85c802cfde8a29eba9f68b783ca60",
            "value": "2606209353475460",
            "gas": "2300",
            "gas_used": "72",
            "input": "0x",
            "output": "0x"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.