> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Historical Transactions

> Retrieve historical transactions for one or multiple wallets with flexible filtering, pagination, and caching options.

<Warning>
  **Deprecated Endpoint**

  This endpoint is deprecated. Please use the new v2 endpoint instead:

  * [/api/2/wallet/activity](/rest-api-reference/endpoint/wallet-activity) — Fetch detailed wallet activity with smart swap detection, spam filtering, and cursor-based pagination
</Warning>

## Query Parameters

* You must provide **either** the `wallet` parameter **or** the `wallets` parameter.

### Query Details

| Parameter        | Type   | Description                                                           |
| ---------------- | ------ | --------------------------------------------------------------------- |
| `wallet`         | Cond.  | Single wallet address to query trades for.                            |
| `wallets`        | string | Comma-separated list of wallet addresses to query.                    |
| `blockchains`    | string | Comma-separated list of blockchain chain IDs/names to filter by.      |
| `limit`          | string | Number of items to return.                                            |
| `offset`         | string | Offset for pagination (alternative to page).                          |
| `page`           | string | Page number for pagination (alternative to offset).                   |
| `order`          | string | Sort order: `"asc"` or `"desc"` by timestamp.                         |
| `from`           | string | Start date filter (ISO string or timestamp).                          |
| `to`             | string | End date filter (ISO string or timestamp).                            |
| `asset`          | string | Filter by specific asset address.                                     |
| `unlistedAssets` | string | Include unlisted or non-indexed assets (boolean).                     |
| `pagination`     | string | Set to `"true"` to include pagination metadata. Default is `"false"`. |
| `filterSpam`     | string | Filter out spam tokens (boolean).                                     |

### Usage Examples

* Query Wallet Transactions with Unlisted Assets and Pagination

```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/wallet/transactions?wallet=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43&unlistedAssets=true&pagination=true"
```

* Query Wallet Transactions Filtered by Date Range

```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/wallet/transactions?wallet=4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ&from=1704067200000&to=1735689600000"
```


## OpenAPI

````yaml get /1/wallet/transactions
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /1/wallet/transactions:
    get:
      tags:
        - V1 - Wallet
      summary: Get wallet transactions
      parameters:
        - schema:
            type: string
            description: Number of results per page
          required: false
          description: Number of results per page
          name: limit
          in: query
        - schema:
            type: string
            description: Offset for pagination
          required: false
          description: Offset for pagination
          name: offset
          in: query
        - schema:
            type: string
            description: Page number
          required: false
          description: Page number
          name: page
          in: query
        - schema:
            type: string
            description: Sort order (asc/desc)
          required: false
          description: Sort order (asc/desc)
          name: order
          in: query
        - schema:
            type: string
            description: Wallet address
          required: false
          description: Wallet address
          name: wallet
          in: query
        - schema:
            type: string
            description: Comma-separated wallet addresses
          required: false
          description: Comma-separated wallet addresses
          name: wallets
          in: query
        - schema:
            type: string
            description: Start timestamp
          required: false
          description: Start timestamp
          name: from
          in: query
        - schema:
            type: string
            description: End timestamp
          required: false
          description: End timestamp
          name: to
          in: query
        - schema:
            type: string
            description: Filter by asset address
          required: false
          description: Filter by asset address
          name: asset
          in: query
        - schema:
            type: string
            description: Comma-separated blockchain IDs
          required: false
          description: Comma-separated blockchain IDs
          name: blockchains
          in: query
        - schema:
            type: string
            description: Include unlisted assets
          required: false
          description: Include unlisted assets
          name: unlistedAssets
          in: query
        - schema:
            type: string
            description: Enable pagination details
          required: false
          description: Enable pagination details
          name: pagination
          in: query
        - schema:
            type: string
            description: Filter spam transactions
          required: false
          description: Filter spam transactions
          name: filterSpam
          in: query
      responses:
        '200':
          description: Wallet transactions response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      transactions:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            timestamp:
                              type: number
                            from:
                              type: string
                              nullable: true
                            to:
                              type: string
                              nullable: true
                            contract:
                              type: string
                              nullable: true
                            hash:
                              type: string
                            amount_usd:
                              type: number
                            amount:
                              type: number
                            block_number:
                              type: number
                            type:
                              type: string
                            blockchain:
                              type: string
                            tx_cost:
                              type: number
                            transaction:
                              type: object
                              properties:
                                hash:
                                  type: string
                                chainId:
                                  type: string
                                fees:
                                  type: string
                                feesUSD:
                                  type: number
                                date:
                                  type: string
                                  nullable: true
                              required:
                                - hash
                                - chainId
                                - fees
                                - feesUSD
                                - date
                            asset:
                              type: object
                              properties:
                                id:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                symbol:
                                  type: string
                                decimals:
                                  type: number
                                totalSupply:
                                  type: number
                                circulatingSupply:
                                  type: number
                                price:
                                  type: number
                                liquidity:
                                  type: number
                                priceChange24hPercent:
                                  type: number
                                marketCapUSD:
                                  type: number
                                logo:
                                  type: string
                                  nullable: true
                                nativeChainId:
                                  type: string
                                  nullable: true
                                contract:
                                  type: string
                                  nullable: true
                              required:
                                - id
                                - name
                                - symbol
                                - decimals
                                - totalSupply
                                - circulatingSupply
                                - price
                                - liquidity
                                - priceChange24hPercent
                                - marketCapUSD
                                - logo
                                - nativeChainId
                                - contract
                          required:
                            - id
                            - timestamp
                            - from
                            - to
                            - contract
                            - hash
                            - amount_usd
                            - amount
                            - block_number
                            - type
                            - blockchain
                            - tx_cost
                            - transaction
                            - asset
                      wallets:
                        type: array
                        items:
                          type: string
                    required:
                      - transactions
                      - wallets
                  details:
                    nullable: true
                  pagination:
                    type: object
                    nullable: true
                    properties:
                      total:
                        type: number
                      page:
                        type: number
                      offset:
                        type: number
                      limit:
                        type: number
                    required:
                      - total
                      - page
                      - offset
                      - limit
                required:
                  - data
                  - details
                  - pagination

````