---
title: "Transactions"
method: POST
path: "/api/v1/developer/wallet/transactions"
tags: ["WALLET", "DEVELOPER"]
---

# Transactions

`POST /api/v1/developer/wallet/transactions`

Provides enriched transaction history data for wallet(s).

## Query parameters

- `activity_type` string — Activity type to filter transactions by
- `limit` integer — Limit the number of transactions returned. Default is 25.
- `transaction_hash` string — Filter by transaction hash
- `cursor` string — Cursor to request the next page of results.

## Request body

- PayloadAddress[] — List of chain+addresses to get transactions for.
  - `chain` string, required — Lowercase chain name
  - `address` string, required — Wallet address

## Response `200`

Successful Response

- WalletTransactionsEnvelope
  - `items` union[], required
    - union
      - EVMWalletTransaction
        - `id` string, required
        - `type` integer, nullable, required
        - `address` string, required
        - `chain` string, required
        - `hash` string, required
        - `index` integer, required
        - `within_block_order_key` integer, required
        - `block_timestamp` string, date-time, required
        - `block_number` integer, required
        - `block_hash` string, nullable, required
        - `fee` AssetAmount, required
          - `raw_amount` string, nullable, required
          - `amount_str` string, nullable
          - `amount` number, nullable
        - `labels` string[], required
        - `from_address` string, nullable, required
        - `to_address` string, nullable, required
        - `asset_transfers` ApiServerAppRoutesApiDeveloperWalletTransactionsEVMTransfer[], required
          - `transfer_type` 'sent' | 'received', required
          - `operation` 'mint' | 'burn', nullable
          - `transaction_hash` string, required
          - `log_index` integer, nullable
          - `from_address` string, required
          - `to_address` string, required
          - `asset` EVMAsset, required
            - `type` 'native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155', nullable, required
            - `address` string, nullable
            - `name` string, nullable
            - `symbol` string, nullable
            - `decimals` integer, nullable
            - `token_id` string, nullable
          - `amount` AssetAmount, required
            - `raw_amount` string, nullable, required
            - `amount_str` string, nullable
            - `amount` number, nullable
        - `activities` union[], required
          - union
            - EVMAssetApprovalActivity
              - …
            - EVMNFTTradeActivity
              - …
            - EVMDexTradeActivity
              - …
            - EVMDexLiquidityPoolCreatedActivity
              - …
            - EVMAssetBridgeActivity
              - …
            - EVMDexLiquidityPoolBurnActivity
              - …
            - EVMDexLiquidityPoolMintActivity
              - …
      - SolanaWalletTransaction
        - `id` string, required
        - `address` string, required
        - `chain` string, required
        - `hash` string, required
        - `index` integer, required
        - `within_block_order_key` integer, required
        - `block_timestamp` string, date-time, required
        - `block_number` integer, required
        - `block_hash` string, nullable, required
        - `fee` AssetAmount, required
          - `raw_amount` string, nullable, required
          - `amount_str` string, nullable
          - `amount` number, nullable
        - `labels` string[], required
        - `from_address` string, nullable, required
        - `to_address` string, nullable, required
        - `asset_transfers` SolanaAssetTransfer[], required
          - `transaction_hash` string, nullable
          - `log_index` integer, nullable
          - `transfer_type` 'sent' | 'received' | 'invalid' | 'minted' | 'burned', required
          - `from_address` string, nullable
          - `to_address` string, nullable
          - `from_token_account` string, nullable
          - `to_token_account` string, nullable
          - `asset` SolanaAsset, required
            - `type` 'native' | 'sol_spl' | 'sol_nft', nullable, required
            - `address` string, nullable
            - `name` string, nullable
            - `symbol` string, nullable
            - `decimals` integer, nullable
            - `token_id` string, nullable
          - `amount` AssetAmount, required
            - `raw_amount` string, nullable, required
            - `amount_str` string, nullable
            - `amount` number, nullable
        - `activities` union[], required
          - union
            - SolanaNFTTradeActivity
              - …
            - SolanaDEXTradeActivity
              - …
      - BitcoinWalletTransaction
        - `id` string, required
        - `address` string, required
        - `chain` string, required
        - `hash` string, required
        - `index` integer, required
        - `within_block_order_key` integer, required
        - `block_timestamp` string, date-time, required
        - `block_number` integer, required
        - `block_hash` string, nullable, required
        - `fee` AssetAmount, required
          - `raw_amount` string, nullable, required
          - `amount_str` string, nullable
          - `amount` number, nullable
        - `labels` string[], required
        - `asset_transfers` BitcoinAssetTransfer[], required
          - `transfer_type` 'sent' | 'received', required
          - `from_address` string, nullable
          - `to_address` string, nullable
          - `asset` union, required
            - NativeAssetDetail
              - …
            - BRC20AssetDetail
              - …
            - OrdinalInscriptionAssetDetail
              - …
          - `amount` AssetAmount, required
            - `raw_amount` string, nullable, required
            - `amount_str` string, nullable
            - `amount` number, nullable
        - `activities` unknown[], required
          - unknown
      - StellarWalletTransaction
        - `id` string, required
        - `address` string, required
        - `chain` string, required
        - `hash` string, required
        - `index` integer, required
        - `within_block_order_key` integer, required
        - `block_timestamp` string, date-time, required
        - `block_number` integer, required
        - `block_hash` string, nullable, required
        - `fee` AssetAmount, required
          - `raw_amount` string, nullable, required
          - `amount_str` string, nullable
          - `amount` number, nullable
        - `labels` string[], required
        - `asset_transfers` StellarAssetTransfer[], required
          - `transfer_type` 'sent' | 'received', required
          - `from_address` string, nullable
          - `to_address` string, nullable
          - `asset` union, required
            - StellarNativeAssetDetail
              - …
            - StellarTokenAssetDetail
              - …
          - `amount` AssetAmount, required
            - `raw_amount` string, nullable, required
            - `amount_str` string, nullable
            - `amount` number, nullable
        - `activities` StellarTrustlineChangedActivity[], required
          - `type` 'trustline_changed'
          - `effect_type` 'trustline_created' | 'trustline_removed' | 'trustline_updated', required
          - `asset` union, required
            - StellarNativeAssetDetail
              - …
            - StellarTokenAssetDetail
              - …
          - `limit` AssetAmount, required
            - `raw_amount` string, nullable, required
            - `amount_str` string, nullable
            - `amount` number, nullable
      - NearWalletTransaction
        - `address` string, required
        - `chain` string, required
        - `hash` string, required
        - `index` integer, required
        - `within_block_order_key` integer, required
        - `block_timestamp` string, date-time, required
        - `block_number` integer, required
        - `block_hash` string, required
        - `fee` AssetAmount, required
          - `raw_amount` string, nullable, required
          - `amount_str` string, nullable
          - `amount` number, nullable
        - `labels` string[], required
        - `from_address` string, required
        - `asset_transfers` NearAssetTransfer[], required
          - `from_address` string, required
          - `to_address` string, required
          - `asset` NearAsset, required
            - `address` string, nullable
            - `symbol` string, nullable
            - `name` string, nullable
            - `decimals` integer, nullable
          - `amount` AssetAmount, required
            - `raw_amount` string, nullable, required
            - `amount_str` string, nullable
            - `amount` number, nullable
        - `activities` unknown[], required
          - unknown
  - `cursor` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)
