NFT
- NFT Data Overview
- GETNFT Tokens by Contract
- GETNFT Token by Contract and Token ID
- GETNFT Contract
- GETNFT Collections
- GETNFT Listings by Contract Address
- GETNFT Listings by Token ID
- GETNFT Transfers by Token ID
- GETNFT Transfers by Contract Address
- GETNFT Activities by Token ID
- GETNFT Activities by Contract Address
Wallets
Data Transformations
- Data Transformations Overview
- Filter Data Sources
- Filters
- Workflows
Chains
- Overview
- Solana
- Bitcoin
- Ethereum
- Polygon
- Arbitrum
- Base
- Optimism
- Oasys
Deep Dives
Activities
Get a list of wallet activities.
POST
/
api
/
v1
/
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": [
{
"type": "traded_nft",
"side": "buyer",
"log_index": 123,
"asset": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>",
"address": "<string>"
},
"asset_amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
},
"currency": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>",
"address": "<string>"
},
"currency_amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
},
"marketplace": "<string>",
"protocol": "<string>"
}
]
}
],
"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 | 7 days only | 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
Query Parameters
Window of days to fetch activities for. Default is 31.
Required range:
x > 0
Max number of items returned. Default is 100.
Required range:
x > 0
Cursor to request the next page of results.
Response
200
application/json
Successful Response
AssetTransfer to represent the asset transfer.
Available options:
sent
, received
, invalid
Available options:
native
, evm_erc20
, evm_erc721
, evm_erc1155
, sol_spl
, sol_nft
, btc_inscription
, btc_brc20
, btc_rune
, sui_token
Available options:
buyer
, seller
Available options:
native
, evm_erc20
, evm_erc721
, evm_erc1155
, sol_spl
, sol_nft
, btc_inscription
, btc_brc20
, btc_rune
, sui_token
Available options:
native
, evm_erc20
, evm_erc721
, evm_erc1155
, sol_spl
, sol_nft
, btc_inscription
, btc_brc20
, btc_rune
, sui_token
Available options:
swapped_tokens
, traded_nft
, approval
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": [
{
"type": "traded_nft",
"side": "buyer",
"log_index": 123,
"asset": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>",
"address": "<string>"
},
"asset_amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
},
"currency": {
"type": "native",
"name": "<string>",
"symbol": "<string>",
"decimals": 123,
"token_id": "<string>",
"address": "<string>"
},
"currency_amount": {
"raw_amount": "<string>",
"amount_str": "<string>",
"amount": 123
},
"marketplace": "<string>",
"protocol": "<string>"
}
]
}
],
"cursor": "<string>"
}