Fetch transactions

Get rich transaction activity data for wallets, including activities, asset transfers, and labels.

POST /api/v1/developer/wallet/transactions

Transactions

cURL

curl --request POST \
  --url https://api.allium.so/api/v1/developer/wallet/transactions \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
[
  {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }
]
'

200

{
  "items": [
    {
      "id": "<string>",
      "type": 123,
      "address": "<string>",
      "chain": "<string>",
      "hash": "<string>",
      "index": 123,
      "within_block_order_key": 123,
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_number": 123,
      "block_hash": "<string>",
      "fee": {
        "raw_amount": "<string>",
        "amount_str": "<string>",
        "amount": 123
      },
      "labels": [
        "<string>"
      ],
      "from_address": "<string>",
      "to_address": "<string>",
      "asset_transfers": [
        {
          "transaction_hash": "<string>",
          "from_address": "<string>",
          "to_address": "<string>",
          "asset": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>"
          },
          "amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          },
          "log_index": 123
        }
      ],
      "activities": [
        {
          "asset": {
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>"
          },
          "transaction_hash": "<string>",
          "contract_address": "<string>",
          "spender_address": "<string>",
          "approved_amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          },
          "type": "asset_approval",
          "log_index": 123,
          "trace_index": 123
        }
      ]
    }
  ],
  "cursor": "<string>"
}

Each transaction in the response includes activities, asset transfers, and labels (where supported).

Supported Chains

Feature Support by Chain

Feature	EVM	Solana	Bitcoin
History	Since genesis	Since 2022-01-01	Since genesis
Asset transfers	✅	✅	✅
Activities	✅	✅	❌
Labels	✅	❌	❌

Supported Activities by Chain

Activity	Type	EVM	Solana	Bitcoin
Asset Approval	asset_approval	✅	N/A	❌
Asset Bridge	asset_bridge	✅	N/A	❌
DEX Trade	dex_trade	✅	✅	❌
Liquidity Pool Burn	dex_liquidity_pool_burn	✅	❌	❌
Liquidity Pool Mint	dex_liquidity_pool_mint	✅	❌	❌
Liquidity Pool Created	dex_liquidity_pool_created	✅	❌	❌
NFT Trade	nft_trade	✅	✅ (Magic Eden v2 only)	❌

Authorizations

X-API-KEY · string · header · required

Query Parameters

activity_type · string

Activity type to filter transactions by

limit · integer · default: 25

Limit the number of transactions returned. Default is 25.

Required range: x <= 1000

transaction_hash · string

Filter by transaction hash

cursor · string

Cursor to request the next page of results.

Body

application/json

Required array length: 1 - 20 elements

chain · string · required

Lowercase chain name

address · string · required

Wallet address

Response

200

application/json

Successful Response

items · (EVMWalletTransaction · object | SolanaWalletTransaction · object | BitcoinWalletTransaction · object | StellarWalletTransaction · object | NearWalletTransaction · object)[] · required

EVMWalletTransaction

SolanaWalletTransaction

BitcoinWalletTransaction

StellarWalletTransaction

NearWalletTransaction

Show child attributes

cursor · string | null