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>",
      "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": [
        {
          "transfer_type": "sent",
          "transaction_hash": "<string>",
          "log_index": 123,
          "from_address": "<string>",
          "to_address": "<string>",
          "asset": {
            "type": "native",
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>"
          },
          "amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          }
        }
      ],
      "activities": [
        {
          "transaction_hash": "<string>",
          "log_index": 123,
          "trace_index": 123,
          "type": "asset_approval",
          "asset": {
            "type": "native",
            "address": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "token_id": "<string>"
          },
          "spender_address": "<string>",
          "approved_amount": {
            "raw_amount": "<string>",
            "amount_str": "<string>",
            "amount": 123
          },
          "status": "approved",
          "granularity": "token"
        }
      ]
    }
  ],
  "cursor": "<string>"
}

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

​
Supported Chains

  • 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.

ActivityTypeEVMSolanaSUI
Asset Approvalasset_approval✅❌❌
Asset Bridgeasset_bridge✅❌❌
DEX Tradedex_trade✅🔜✅ (only Cetus DEX trades)
Liquidity Pool Burndex_liquidity_pool_burn✅❌❌
Liquidity Pool Mintdex_liquidity_pool_mint✅❌❌
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[]

List of chain+address pairs to get transactions for.

Response

200
application/json
Successful Response

The response is of type object.