POST
/
api
/
v1
/
developer
/
wallet
/
transactions
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": "<string>",
    "address": "<string>"
  }
]'
{
  "items": [
    {
      "id": "<string>",
      "chain": "<string>",
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_number": 123,
      "block_hash": "<string>",
      "hash": "<string>",
      "fee": {
        "raw_amount": "<string>",
        "amount_str": "<string>",
        "amount": 123
      },
      "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": "nft_trade",
          "side": "buyer",
          "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>"
}

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

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

​
Supported Chains

  • Bitcoin bitcoin
  • EVM
    • Abstract abstract
    • ApeChain apechain
    • Arbitrum arbitrum
    • Base base
    • BSC bsc
    • Ethereum ethereum
    • Polygon polygon
    • Monad testnet monad_testnet
    • SEI sei
  • Solana solana
  • SUI sui

​
Feature Support by Chain

The following table lists the features we support for each chain.

FeatureEVMSolanaSui (alpha)
HistorySince genesisSince 2025-01-01Since 2025-01-01
Asset transfers✅✅❌
Activities✅❌✅ (partial support)
Labels🔜❌❌

​
Supported Activities by Chain

The following table lists the activity variants we support for each chain.

ActivityDiscriminator (type)EVMSolanaSUI
Asset approvalasset_approval✅❌❌
DEX Tradedex_trade✅🔜✅ (only Cetus DEX trades)
NFT Tradenft_trade🔜🔜

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
lookback_days
integer
default:31

Window of days to fetch transactions 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 · object[]
​
chain
string
required
​
address
string
required

Response

200
application/json
Successful Response
​
items
object[]
required
​
cursor
string | null