Skip to main content
GET
/
v1
/
wallets
/
{address}
/
transactions
Get wallet transactions
curl --request GET \
  --url https://api.zerion.io/v1/wallets/{address}/transactions/ \
  --header 'Authorization: Basic <encoded-value>'
{
  "links": {
    "self": "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/transactions/?currency=usd&page%5Bsize%5D=10",
    "next": "https://api.zerion.io/v1/wallets/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990/transactions/?currency=usd&page%5BlastId%5D=950ac208a5545dd19a1b2eb8edaef36c&page%5BlastTimestamp%5D=2022-12-08T09%3A12%3A35Z&page%5Bsize%5D=10"
  },
  "data": [
    {
      "type": "transactions",
      "id": "52d994a173d755e99845e861d534a419",
      "attributes": {
        "operation_type": "trade",
        "hash": "0x109d8622084d562263230ba5de412b5cd7c372019131e2c9d0a8aa4925eb6034",
        "mined_at_block": 15345739,
        "mined_at": "2022-08-15T11:26:31+00:00",
        "sent_from": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
        "sent_to": "0x794a61358d6845594f94dc1db02a252b5b4814ad",
        "status": "confirmed",
        "nonce": 3757,
        "fee": {
          "fungible_info": {
            "name": "Bankless BED Index",
            "symbol": "BED",
            "icon": {
              "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
            },
            "flags": {
              "verified": true
            },
            "implementations": [
              {
                "chain_id": "ethereum",
                "decimals": 18,
                "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
              }
            ],
            "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
            "description": "The BED index is meant to track crypto’s top 3 investab.",
            "market_data": {
              "price": 106.87952669793131,
              "total_supply": 29905.762448515918,
              "circulating_supply": 29905.762448515918,
              "fully_diluted_valuation": 3196313.736038149,
              "market_cap": 3196313.736038149,
              "changes": {
                "percent_1d": -0.7379066649086338,
                "percent_30d": -2.499465618806962,
                "percent_90d": 11.316340269371775,
                "percent_365d": null
              },
              "trading_volumes": {
                "volume_1d": 40096375.69294812
              }
            }
          },
          "quantity": {
            "int": "12345678",
            "decimals": 5,
            "float": 123.45678,
            "numeric": "123.45678"
          },
          "price": 2542.23,
          "value": 39.965672931101786
        },
        "transfers": [
          {
            "direction": "in",
            "quantity": {
              "int": "12345678",
              "decimals": 5,
              "float": 123.45678,
              "numeric": "123.45678"
            },
            "value": 0,
            "price": 0,
            "sender": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "recipient": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "act_id": "2",
            "fungible_info": {
              "name": "Bankless BED Index",
              "symbol": "BED",
              "icon": {
                "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
              },
              "flags": {
                "verified": true
              },
              "implementations": [
                {
                  "chain_id": "ethereum",
                  "decimals": 18,
                  "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
                }
              ],
              "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
              "description": "The BED index is meant to track crypto’s top 3 investab.",
              "market_data": {
                "price": 106.87952669793131,
                "total_supply": 29905.762448515918,
                "circulating_supply": 29905.762448515918,
                "fully_diluted_valuation": 3196313.736038149,
                "market_cap": 3196313.736038149,
                "changes": {
                  "percent_1d": -0.7379066649086338,
                  "percent_30d": -2.499465618806962,
                  "percent_90d": 11.316340269371775,
                  "percent_365d": null
                },
                "trading_volumes": {
                  "volume_1d": 40096375.69294812
                }
              }
            },
            "nft_info": {
              "contract_address": "0x74ee68a33f6c9f113e22b3b77418b75f85d07d22",
              "token_id": "10",
              "name": "#10 De·genesis",
              "interface": "erc1155",
              "flags": {
                "is_spam": true
              },
              "content": {
                "preview": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "detail": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "audio": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "video": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                }
              }
            }
          }
        ],
        "approvals": [
          {
            "quantity": {
              "int": "12345678",
              "decimals": 5,
              "float": 123.45678,
              "numeric": "123.45678"
            },
            "sender": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "act_id": "1",
            "fungible_info": {
              "name": "Bankless BED Index",
              "symbol": "BED",
              "icon": {
                "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
              },
              "flags": {
                "verified": true
              },
              "implementations": [
                {
                  "chain_id": "ethereum",
                  "decimals": 18,
                  "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
                }
              ],
              "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
              "description": "The BED index is meant to track crypto’s top 3 investab.",
              "market_data": {
                "price": 106.87952669793131,
                "total_supply": 29905.762448515918,
                "circulating_supply": 29905.762448515918,
                "fully_diluted_valuation": 3196313.736038149,
                "market_cap": 3196313.736038149,
                "changes": {
                  "percent_1d": -0.7379066649086338,
                  "percent_30d": -2.499465618806962,
                  "percent_90d": 11.316340269371775,
                  "percent_365d": null
                },
                "trading_volumes": {
                  "volume_1d": 40096375.69294812
                }
              }
            },
            "nft_info": {
              "contract_address": "0x74ee68a33f6c9f113e22b3b77418b75f85d07d22",
              "token_id": "10",
              "name": "#10 De·genesis",
              "interface": "erc1155",
              "flags": {
                "is_spam": true
              },
              "content": {
                "preview": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "detail": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "audio": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                },
                "video": {
                  "url": "https://token-icons.s3.amazonaws.com/0x1494ca1f11d487c2bbe4543e90080aeba4ba3c2b.png",
                  "content_type": "image/png"
                }
              }
            }
          }
        ],
        "address": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
        "refund": {
          "fungible_info": {
            "name": "Bankless BED Index",
            "symbol": "BED",
            "icon": {
              "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
            },
            "flags": {
              "verified": true
            },
            "implementations": [
              {
                "chain_id": "ethereum",
                "decimals": 18,
                "address": "0x2af1df3ab0ab157e1e2ad8f88a7d04fbea0c7dc6"
              }
            ],
            "id": "0230395c-2b01-46d8-b2d6-ce8121d51f9e",
            "description": "The BED index is meant to track crypto’s top 3 investab.",
            "market_data": {
              "price": 106.87952669793131,
              "total_supply": 29905.762448515918,
              "circulating_supply": 29905.762448515918,
              "fully_diluted_valuation": 3196313.736038149,
              "market_cap": 3196313.736038149,
              "changes": {
                "percent_1d": -0.7379066649086338,
                "percent_30d": -2.499465618806962,
                "percent_90d": 11.316340269371775,
                "percent_365d": null
              },
              "trading_volumes": {
                "volume_1d": 40096375.69294812
              }
            }
          },
          "quantity": {
            "int": "12345678",
            "decimals": 5,
            "float": 123.45678,
            "numeric": "123.45678"
          },
          "price": 2542.23,
          "value": 5.123456789
        },
        "collection_approvals": [
          {
            "cancelled": true,
            "spender": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
            "act_id": "1",
            "collection_info": {
              "id": "<string>",
              "name": "0x60a26d69263ef43e9a68964ba141263f19d71d51",
              "icon_url": "1"
            }
          }
        ],
        "delegations": [
          {
            "address": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
            "act_id": "1",
            "chain_id": "ethereum"
          }
        ],
        "application_metadata": {
          "contract_address": "0x794a61358d6845594f94dc1db02a252b5b4814ad",
          "name": "AAVE",
          "icon": {
            "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
          },
          "method": {
            "id": "0x095ea7b3",
            "name": "Approve"
          }
        },
        "flags": {
          "is_trash": true
        },
        "acts": [
          {
            "id": "1",
            "type": "trade",
            "application_metadata": {
              "contract_address": "0x794a61358d6845594f94dc1db02a252b5b4814ad",
              "name": "AAVE",
              "icon": {
                "url": "https://token-icons.s3.amazonaws.com/0x0391d2021f89dc339f60fff84546ea23e337750f.png"
              },
              "method": {
                "id": "0x095ea7b3",
                "name": "Approve"
              }
            }
          }
        ],
        "paymaster": "0x794a61358d6845594f94dc1db02a252b5b4814ad"
      },
      "relationships": {
        "chain": {
          "links": {
            "related": "https://api.zerion.io/v1/chains/polygon"
          },
          "data": {
            "type": "chains",
            "id": "polygon"
          }
        },
        "dapp": {
          "data": {
            "type": "dapps",
            "id": "aave-v3"
          }
        }
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
X-Env
enum<string>

Custom header that allows you to get data for testnets.

Available options:
testnet

Path Parameters

​
address
string
required

Address of the wallet.

Query Parameters

​
currency
enum<string>
default:usd

Denominated currency value of returned prices

Available options:
eth,
btc,
usd,
eur,
krw,
rub,
gbp,
aud,
cad,
inr,
jpy,
nzd,
try,
zar,
cny,
chf
​
page
object

Pagination parameters

​
filter[search_query]
string

Query for a full-text search.

Required string length: 2 - 64
Example:

"Trade"

​
filter[operation_types]
enum<string>[]

Return only transactions with specified types (comma-separated list).

Possible values:

  • approve - Grant permission to a smart contract to access and spend tokens on behalf of the wallet
  • burn - Destroy tokens permanently, reducing the total token supply
  • claim - Claim earned rewards, airdrops, or vested tokens from a protocol
  • delegate - Delegate tokens or voting power to another address
  • deploy - Deploy a new smart contract to the blockchain
  • deposit - Deposit assets into a protocol (e.g., lending pool, liquidity pool, vault)
  • execute - Execute a smart contract function or complex interaction that doesn't fit other specific types
  • mint - Create new tokens, increasing the total token supply
  • receive - Receive tokens from another wallet address
  • revoke - Revoke previously granted token spending permissions from a smart contract
  • revoke_delegation - Revoke a previously delegated token or voting power
  • send - Send tokens to another wallet address
  • trade - Exchange or swap assets (e.g., on a DEX)
  • withdraw - Withdraw assets from a protocol (e.g., from lending pools, liquidity pools, or vaults) style: form

Type of the transaction operation. This field indicates the primary action performed in the transaction.

Possible values and their meanings:

  • approve - Grant permission to a smart contract to access and spend tokens on behalf of the wallet
  • bid - Place a bid in a prediction market
  • burn - Destroy tokens permanently, reducing the total token supply
  • claim - Claim earned rewards, airdrops, or vested tokens from a protocol
  • delegate - Delegate tokens or voting power to another address
  • deploy - Deploy a new smart contract to the blockchain
  • deposit - Deposit assets into a protocol (e.g., lending pool, liquidity pool, vault)
  • execute - Execute a smart contract function or complex interaction that doesn't fit other specific types
  • mint - Create new tokens, increasing the total token supply
  • receive - Receive tokens from another wallet address
  • revoke - Revoke previously granted token spending permissions from a smart contract
  • revoke_delegation - Revoke a previously delegated token or voting power
  • send - Send tokens to another wallet address
  • trade - Exchange or swap assets (e.g., on a DEX)
  • withdraw - Withdraw assets from a protocol (e.g., from lending pools, liquidity pools, or vaults)
Available options:
approve,
burn,
claim,
delegate,
deploy,
deposit,
execute,
mint,
receive,
revoke,
revoke_delegation,
send,
trade,
withdraw
​
filter[asset_types]
enum<string>[]

Return only transactions that contain specified asset types (comma-separated list).

Type of concrete asset.

Available options:
fungible,
nft
​
filter[chain_ids]
string[]

Return only transactions from specified chains (comma-separated list). You can find available chain ids in chain endpoints.

​
filter[fungible_ids]
string[]

Return only transactions with fungibles with specified ids (comma-separated list).

​
filter[min_mined_at]
string

Return only transactions since specific date. Timestamp in milliseconds.

Required string length: 13
Example:

"1688842525735"

​
filter[max_mined_at]
string

Return only transactions until specific date. Timestamp in milliseconds.

Required string length: 13
Example:

"1694192535967"

​
filter[trash]
enum<string>
default:no_filter

Filter transactions based on the is_trash flag. If no flag is specified, then no_filter is applied.

Available options:
only_trash,
only_non_trash,
no_filter
​
filter[fungible_implementations]
string[]

Specify implementations of fungible tokens as a comma-separated list of chain:address pairs.

Example format: ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,polygon:0x123456789abcdef123456789abcdef123456789

Each item consists of a blockchain chain_id and an address, separated by a colon (:). Multiple pairs can be provided using commas (,).

Response

Response for requested list of transactions

​
links
object
required
​
data
object[]
required