Activities - Allium Documentation Hub

POST

api

developer

wallet

activities

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

{
  "items": [
    {
      "id": "<string>",
      "chain": "<string>",
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_number": 123,
      "block_hash": "<string>",
      "transaction_hash": "<string>",
      "transaction_fee": {
        "raw_amount": "<string>",
        "amount_str": "<string>",
        "amount": 123
      },
      "transaction_labels": [],
      "from_address": "<string>",
      "to_address": "<string>",
      "within_block_order_key": 123,
      "asset_transfers": [
        {
          "transaction_hash": "<string>",
          "log_index": 123,
          "transfer_type": "sent",
          "from_address": "<string>",
          "to_address": "<string>",
          "from_token_account": "<string>",
          "to_token_account": "<string>",
          "asset": {
            "type": "native",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>",
            "address": "<string>"
          },
          "amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          }
        }
      ],
      "activities": [
        "<any>"
      ]
    }
  ],
  "cursor": "<string>"
}

This endpoint is deprecated. Use the transactions endpoint instead.

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

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	Since 2025	2025 only
Support for token transfers	✅	✅	❌
Activity type User approved a spender for an asset	✅	❌	❌
Activity type User swapped one asset for another	✅	❌	🌱 (only Cetus DEX trades)
Activity type User initiated the transaction	✅	✅	❌
Activity type User interacted with a DApp	✅	✅	❌

Authorizations

X-API-KEY

string

header

required

Query Parameters

lookback_days

integer

default:31

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

Required range: x > 0

limit

integer

default:100

Max number of items returned. Default is 100.

Required range: x > 0

cursor

string

Cursor to request the next page of results.

Body

application/json · PayloadAddress · object[]

List of chain+address pairs to get activities for.

Response

200

application/json

Successful Response

The response is of type object.

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

{
  "items": [
    {
      "id": "<string>",
      "chain": "<string>",
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_number": 123,
      "block_hash": "<string>",
      "transaction_hash": "<string>",
      "transaction_fee": {
        "raw_amount": "<string>",
        "amount_str": "<string>",
        "amount": 123
      },
      "transaction_labels": [],
      "from_address": "<string>",
      "to_address": "<string>",
      "within_block_order_key": 123,
      "asset_transfers": [
        {
          "transaction_hash": "<string>",
          "log_index": 123,
          "transfer_type": "sent",
          "from_address": "<string>",
          "to_address": "<string>",
          "from_token_account": "<string>",
          "to_token_account": "<string>",
          "asset": {
            "type": "native",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>",
            "address": "<string>"
          },
          "amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          }
        }
      ],
      "activities": [
        "<any>"
      ]
    }
  ],
  "cursor": "<string>"
}

POST

api

developer

wallet

activities

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

{
  "items": [
    {
      "id": "<string>",
      "chain": "<string>",
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_number": 123,
      "block_hash": "<string>",
      "transaction_hash": "<string>",
      "transaction_fee": {
        "raw_amount": "<string>",
        "amount_str": "<string>",
        "amount": 123
      },
      "transaction_labels": [],
      "from_address": "<string>",
      "to_address": "<string>",
      "within_block_order_key": 123,
      "asset_transfers": [
        {
          "transaction_hash": "<string>",
          "log_index": 123,
          "transfer_type": "sent",
          "from_address": "<string>",
          "to_address": "<string>",
          "from_token_account": "<string>",
          "to_token_account": "<string>",
          "asset": {
            "type": "native",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>",
            "address": "<string>"
          },
          "amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          }
        }
      ],
      "activities": [
        "<any>"
      ]
    }
  ],
  "cursor": "<string>"
}

This endpoint is deprecated. Use the transactions endpoint instead.

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

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	Since 2025	2025 only
Support for token transfers	✅	✅	❌
Activity type User approved a spender for an asset	✅	❌	❌
Activity type User swapped one asset for another	✅	❌	🌱 (only Cetus DEX trades)
Activity type User initiated the transaction	✅	✅	❌
Activity type User interacted with a DApp	✅	✅	❌

Authorizations

X-API-KEY

string

header

required

Query Parameters

lookback_days

integer

default:31

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

Required range: x > 0

limit

integer

default:100

Max number of items returned. Default is 100.

Required range: x > 0

cursor

string

Cursor to request the next page of results.

Body

application/json · PayloadAddress · object[]

List of chain+address pairs to get activities for.

Response

200

application/json

Successful Response

The response is of type object.

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

{
  "items": [
    {
      "id": "<string>",
      "chain": "<string>",
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_number": 123,
      "block_hash": "<string>",
      "transaction_hash": "<string>",
      "transaction_fee": {
        "raw_amount": "<string>",
        "amount_str": "<string>",
        "amount": 123
      },
      "transaction_labels": [],
      "from_address": "<string>",
      "to_address": "<string>",
      "within_block_order_key": 123,
      "asset_transfers": [
        {
          "transaction_hash": "<string>",
          "log_index": 123,
          "transfer_type": "sent",
          "from_address": "<string>",
          "to_address": "<string>",
          "from_token_account": "<string>",
          "to_token_account": "<string>",
          "asset": {
            "type": "native",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>",
            "address": "<string>"
          },
          "amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          }
        }
      ],
      "activities": [
        "<any>"
      ]
    }
  ],
  "cursor": "<string>"
}