Activities

Provides rich transaction activity data for a wallet(s).

Request

Query Params

• lookback_days - The number of days, relative to today, to fetch transaction activity for.

• limit - The number of elements to return in a single API call.

• cursor (optional) - Each response will include the cursor key that you can use in this param to get the next page of results. You have hit the last page when the items array is empty.

Body

Specify the chain and address for each wallet you would like to receive data for. It is recommended to keep the total number of wallets under 10.

[
    {
        "chain": "ethereum",
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" 
    },
    {
        "chain": "base",
        "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    }
]

Supported Chains

• Bitcoin bitcoin

• EVM Chains

  • Abstract abstract

  • Abstract Testnet abstract_testnet

  • ApeChain apechain

  • Arbitrum arbitrum

  • Base base

  • BSC bsc

  • Ethereum ethereum

  • Polygon polygon

  • Monad Testnet monad_testnet

  • SEI sei

• Solana solana (limited to 7 days of retention - support for full history is in development)

• 🌱 SUI sui (data only from 2025 and only has Cetus DEX trades)

Response

Each item in the response represents a transaction, and includes a list of zero or more transaction labels, asset transfers and activities.

The following table lists the features we support by chain:

Feature	EVM	Solana	Sui (alpha)
Data amount	To genesis	7 days only	2025 only
Support for token transfers	✅	✅	❌
Activity type approval User approved a spender for an asset	✅	❌	❌
Activity type swapped_tokens User swapped one asset for another	✅	❌	🌱 (only Cetus DEX trades)
Activity type sign_tx User initiated the transaction	✅	✅	❌
Activity type dapp_interaction User interacted with a DApp	✅	✅	❌

Activities

post

Provides rich transaction activity data for wallet(s).

Authorizations

APIKeyBearerFirebaseAuthBearerAPIKeyBearerAPIKeyBearer

Query parameters

lookback_daysinteger · default: 31optional

Window of days to fetch activities for. Default is 31.

limitinteger · default: 100optional

Max number of items returned. Default is 100.

cursorany ofoptional

Cursor to request the next page of results.

Header parameters

x-allium-team-idany ofoptional

Body

chainstringrequired

addressstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.allium.so/api/v1/developer/wallet/activities' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "chain": "text",
      "address": "text"
    }
  ]'

200

422

200

{
  "items": [
    {
      "id": "text",
      "chain": "text",
      "block_timestamp": "2025-04-02T21:23:14.642Z",
      "block_number": 1,
      "block_hash": "text",
      "transaction_hash": "text",
      "transaction_fee": {
        "raw_amount": "text",
        "amount_str": "text",
        "amount": 1
      },
      "transaction_labels": [
        "text"
      ],
      "from_address": "text",
      "to_address": "text",
      "within_block_order_key": 1,
      "asset_transfers": [
        {
          "transfer_type": "sent",
          "from_address": "text",
          "to_address": "text",
          "from_token_account": "text",
          "to_token_account": "text",
          "asset": {
            "type": "native",
            "name": "text",
            "symbol": "text",
            "decimals": 1,
            "token_id": "text",
            "address": "text"
          },
          "amount": {
            "raw_amount": "text",
            "amount_str": "text",
            "amount": 1
          }
        }
      ],
      "activities": [
        {
          "type": "swapped_tokens",
          "side": "buyer",
          "asset": {
            "type": "native",
            "name": "text",
            "symbol": "text",
            "decimals": 1,
            "token_id": "text",
            "address": "text"
          },
          "asset_amount": {
            "raw_amount": "text",
            "amount_str": "text",
            "amount": 1
          },
          "currency": {
            "type": "native",
            "name": "text",
            "symbol": "text",
            "decimals": 1,
            "token_id": "text",
            "address": "text"
          },
          "currency_amount": {
            "raw_amount": "text",
            "amount_str": "text",
            "amount": 1
          },
          "marketplace": "text",
          "protocol": "text"
        }
      ]
    }
  ],
  "cursor": "text"
}

Successful Response