---
title: "Get wallet activity batch"
method: POST
path: "/api/2/wallet/activity"
tags: ["V2 - Wallet"]
---

# Get wallet activity batch

`POST /api/2/wallet/activity`

Accepts an array of items, or an object with an `items` array, for batch wallet activity requests. Batch mode supports max 100 wallets.

## Request body

- union
  - object[] — Wallet activity batch items (max 100 wallets)
    - `wallet` string, required — Wallet address
    - `chainIds` string[] — Array of chain IDs (e.g., ["evm:1","evm:8453"]). If omitted, all chains.
    - `blockchains` string[]
    - `blacklist` string[]
    - `offset` number, nullable — Offset for pagination (default: 0)
    - `limit` number, nullable — Number of transactions per page (default: 100)
    - `order` 'asc' | 'desc' — Sort order: asc or desc (default: desc)
    - `unlistedAssets` boolean — Include unlisted assets (default: true)
    - `filterSpam` boolean — Filter spam transactions (default: true)
    - `backfillTransfers` boolean
    - `backfillBalances` boolean
    - `cursorHash` string — Cursor hash for cursor-based pagination
    - `cursorDirection` 'before' | 'after' — Cursor direction: before or after
    - `withTokens` boolean — Include token details in the response
    - `enrichSwaps` boolean — Enrich swap actions with platform and fee data
    - `from` number, nullable — Start timestamp in milliseconds
    - `to` number, nullable — End timestamp in milliseconds
  - object
    - `items` object[], required — Wallet activity batch items (max 100 wallets)
      - `wallet` string, required — Wallet address
      - `chainIds` string[] — Array of chain IDs (e.g., ["evm:1","evm:8453"]). If omitted, all chains.
      - `blockchains` string[]
      - `blacklist` string[]
      - `offset` number, nullable — Offset for pagination (default: 0)
      - `limit` number, nullable — Number of transactions per page (default: 100)
      - `order` 'asc' | 'desc' — Sort order: asc or desc (default: desc)
      - `unlistedAssets` boolean — Include unlisted assets (default: true)
      - `filterSpam` boolean — Filter spam transactions (default: true)
      - `backfillTransfers` boolean
      - `backfillBalances` boolean
      - `cursorHash` string — Cursor hash for cursor-based pagination
      - `cursorDirection` 'before' | 'after' — Cursor direction: before or after
      - `withTokens` boolean — Include token details in the response
      - `enrichSwaps` boolean — Enrich swap actions with platform and fee data
      - `from` number, nullable — Start timestamp in milliseconds
      - `to` number, nullable — End timestamp in milliseconds

## Response `201`

Wallet activity batch response

- object
  - `payload` union[], required
    - union
      - object
        - `data` object[], required
          - `chainId` string, required
          - `txDateMs` number, required
          - `txDateIso` string, required
          - `txHash` string, required
          - `txRawFeesNative` string, required
          - `txFeesNativeUsd` number, required
          - `txBlockNumber` number, required
          - `txIndex` number, required
          - `txAction` string, nullable
          - `actions` object[], required
            - `model` 'swap' | 'transfer', required
            - `swapType` 'REGULAR' | 'MEV' | 'SANDWICHED_MEV' | 'DEPOSIT' | 'WITHDRAW'
            - `swapRawAmountOut` number
            - `swapRawAmountIn` number
            - `swapAmountOut` number
            - `swapAmountIn` number
            - `swapPriceUsdTokenOut` number
            - `swapPriceUsdTokenIn` number
            - `swapAmountUsd` number
            - `swapTransactionSenderAddress` string
            - `swapBaseAddress` string
            - `swapQuoteAddress` string
            - `swapAmountQuote` number
            - `swapAmountBase` number
            - `swapAssetIn` object
              - …
            - `swapAssetOut` object
              - …
            - `swapPlatform` object, nullable
              - …
            - `swapTotalFeesUsd` number, nullable
            - `swapGasFeesUsd` number, nullable
            - `swapPlatformFeesUsd` number, nullable
            - `swapMevFeesUsd` number, nullable
            - `transferRawAmount` string
            - `transferAmount` number
            - `transferAmountUsd` number
            - `transferType` 'VAULT_DEPOSIT' | 'VAULT_WITHDRAW' | 'VAULT_UNSTAKE' | 'TOKEN_IN' | 'TOKEN_OUT' | 'NATIVE_IN' | 'NATIVE_OUT'
            - `transferFromAddress` string, nullable
            - `transferToAddress` string, nullable
            - `transferAsset` object
              - …
        - `pagination` object, required
          - `page` number, required
          - `offset` number, required
          - `limit` number, required
          - `pageEntries` number, required
        - `backfillStatus` 'processed' | 'processing' | 'pending'
        - `tokens` object[]
          - `address` string, required
          - `chainId` string, required
          - `symbol` string, nullable, required
          - `name` string, nullable, required
          - `decimals` number, nullable
          - `id` number, nullable
          - `priceUSD` number, nullable
          - `priceToken` number, nullable
          - `priceTokenString` string, required
          - `approximateReserveUSD` number, nullable
          - `approximateReserveTokenRaw` string, required
          - `approximateReserveToken` number, nullable
          - `totalSupply` number, nullable
          - `circulatingSupply` number, nullable
          - `marketCapUSD` number, nullable
          - `marketCapDilutedUSD` number, nullable
          - `logo` string, nullable, required
          - `originLogoUrl` string, nullable
          - `rank` number, nullable
          - `cexs` string[]
          - `exchange` object
            - `name` string, required
            - `logo` string, required
          - `factory` string, nullable
          - `source` string, nullable
          - `sourceFactory` string, nullable
          - `sourceMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `sourceFactoryMetadata` object, nullable
            - `name` string, required
            - `logo` string, required
          - `liquidityUSD` number, nullable
          - `liquidityMaxUSD` number, nullable
          - `bonded` boolean
          - `bondingPercentage` number, nullable
          - `bondingCurveAddress` string, nullable
          - `preBondingFactory` string
          - `poolAddress` string
          - `blockchain` string
          - `type` string
          - `tokenType` '2020' | '2022', nullable
          - `deployer` string, nullable
          - `bondedAt` string, nullable, required
          - `athUSD` number, nullable
          - `atlUSD` number, nullable
          - `athDate` string, nullable
          - `atlDate` string, nullable
          - `priceChange1minPercentage` number, nullable
          - `priceChange5minPercentage` number, nullable
          - `priceChange1hPercentage` number, nullable
          - `priceChange4hPercentage` number, nullable
          - `priceChange6hPercentage` number, nullable
          - `priceChange12hPercentage` number, nullable
          - `priceChange24hPercentage` number, nullable
          - `poolPriceChange1minPercentage` number, nullable
          - `poolPriceChange5minPercentage` number, nullable
          - `poolPriceChange1hPercentage` number, nullable
          - `poolPriceChange4hPercentage` number, nullable
          - `poolPriceChange6hPercentage` number, nullable
          - `poolPriceChange12hPercentage` number, nullable
          - `poolPriceChange24hPercentage` number, nullable
          - `liquidityBurnPercentage` number, nullable
          - `volume1minUSD` number, nullable
          - `volume5minUSD` number, nullable
          - `volume15minUSD` number, nullable
          - `volume1hUSD` number, nullable
          - `volume4hUSD` number, nullable
          - `volume6hUSD` number, nullable
          - `volume12hUSD` number, nullable
          - `volume24hUSD` number, nullable
          - `volumeBuy1minUSD` number, nullable
          - `volumeBuy5minUSD` number, nullable
          - `volumeBuy15minUSD` number, nullable
          - `volumeBuy1hUSD` number, nullable
          - `volumeBuy4hUSD` number, nullable
          - `volumeBuy6hUSD` number, nullable
          - `volumeBuy12hUSD` number, nullable
          - `volumeBuy24hUSD` number, nullable
          - `volumeSell1minUSD` number, nullable
          - `volumeSell5minUSD` number, nullable
          - `volumeSell15minUSD` number, nullable
          - `volumeSell1hUSD` number, nullable
          - `volumeSell4hUSD` number, nullable
          - `volumeSell6hUSD` number, nullable
          - `volumeSell12hUSD` number, nullable
          - `volumeSell24hUSD` number, nullable
          - `trades1min` number, nullable
          - `trades5min` number, nullable
          - `trades15min` number, nullable
          - `trades1h` number, nullable
          - `trades4h` number, nullable
          - `trades6h` number, nullable
          - `trades12h` number, nullable
          - `trades24h` number, nullable
          - `buys1min` number, nullable
          - `buys5min` number, nullable
          - `buys15min` number, nullable
          - `buys1h` number, nullable
          - `buys4h` number, nullable
          - `buys6h` number, nullable
          - `buys12h` number, nullable
          - `buys24h` number, nullable
          - `sells1min` number, nullable
          - `sells5min` number, nullable
          - `sells15min` number, nullable
          - `sells1h` number, nullable
          - `sells4h` number, nullable
          - `sells6h` number, nullable
          - `sells12h` number, nullable
          - `sells24h` number, nullable
          - `buyers1min` number, nullable
          - `buyers5min` number, nullable
          - `buyers15min` number, nullable
          - `buyers1h` number, nullable
          - `buyers4h` number, nullable
          - `buyers6h` number, nullable
          - `buyers12h` number, nullable
          - `buyers24h` number, nullable
          - `sellers1min` number, nullable
          - `sellers5min` number, nullable
          - `sellers15min` number, nullable
          - `sellers1h` number, nullable
          - `sellers4h` number, nullable
          - `sellers6h` number, nullable
          - `sellers12h` number, nullable
          - `sellers24h` number, nullable
          - `traders1min` number, nullable
          - `traders5min` number, nullable
          - `traders15min` number, nullable
          - `traders1h` number, nullable
          - `traders4h` number, nullable
          - `traders6h` number, nullable
          - `traders12h` number, nullable
          - `traders24h` number, nullable
          - `feesPaid1minUSD` number, nullable
          - `feesPaid5minUSD` number, nullable
          - `feesPaid15minUSD` number, nullable
          - `feesPaid1hUSD` number, nullable
          - `feesPaid4hUSD` number, nullable
          - `feesPaid6hUSD` number, nullable
          - `feesPaid12hUSD` number, nullable
          - `feesPaid24hUSD` number, nullable
          - `totalFeesPaidUSD` number, nullable
          - `totalFeesPaidNativeRaw` string, nullable
          - `organicTrades1min` number, nullable
          - `organicTrades5min` number, nullable
          - `organicTrades15min` number, nullable
          - `organicTrades1h` number, nullable
          - `organicTrades4h` number, nullable
          - `organicTrades6h` number, nullable
          - `organicTrades12h` number, nullable
          - `organicTrades24h` number, nullable
          - `organicTraders1min` number, nullable
          - `organicTraders5min` number, nullable
          - `organicTraders15min` number, nullable
          - `organicTraders1h` number, nullable
          - `organicTraders4h` number, nullable
          - `organicTraders6h` number, nullable
          - `organicTraders12h` number, nullable
          - `organicTraders24h` number, nullable
          - `organicVolume1minUSD` number, nullable
          - `organicVolume5minUSD` number, nullable
          - `organicVolume15minUSD` number, nullable
          - `organicVolume1hUSD` number, nullable
          - `organicVolume4hUSD` number, nullable
          - `organicVolume6hUSD` number, nullable
          - `organicVolume12hUSD` number, nullable
          - `organicVolume24hUSD` number, nullable
          - `organicVolumeBuy1minUSD` number, nullable
          - `organicVolumeBuy5minUSD` number, nullable
          - `organicVolumeBuy15minUSD` number, nullable
          - `organicVolumeBuy1hUSD` number, nullable
          - `organicVolumeBuy4hUSD` number, nullable
          - `organicVolumeBuy6hUSD` number, nullable
          - `organicVolumeBuy12hUSD` number, nullable
          - `organicVolumeBuy24hUSD` number, nullable
          - `organicVolumeSell1minUSD` number, nullable
          - `organicVolumeSell5minUSD` number, nullable
          - `organicVolumeSell15minUSD` number, nullable
          - `organicVolumeSell1hUSD` number, nullable
          - `organicVolumeSell4hUSD` number, nullable
          - `organicVolumeSell6hUSD` number, nullable
          - `organicVolumeSell12hUSD` number, nullable
          - `organicVolumeSell24hUSD` number, nullable
          - `organicBuys1min` number, nullable
          - `organicBuys5min` number, nullable
          - `organicBuys15min` number, nullable
          - `organicBuys1h` number, nullable
          - `organicBuys4h` number, nullable
          - `organicBuys6h` number, nullable
          - `organicBuys12h` number, nullable
          - `organicBuys24h` number, nullable
          - `organicSells1min` number, nullable
          - `organicSells5min` number, nullable
          - `organicSells15min` number, nullable
          - `organicSells1h` number, nullable
          - `organicSells4h` number, nullable
          - `organicSells6h` number, nullable
          - `organicSells12h` number, nullable
          - `organicSells24h` number, nullable
          - `organicBuyers1min` number, nullable
          - `organicBuyers5min` number, nullable
          - `organicBuyers15min` number, nullable
          - `organicBuyers1h` number, nullable
          - `organicBuyers4h` number, nullable
          - `organicBuyers6h` number, nullable
          - `organicBuyers12h` number, nullable
          - `organicBuyers24h` number, nullable
          - `organicSellers1min` number, nullable
          - `organicSellers5min` number, nullable
          - `organicSellers15min` number, nullable
          - `organicSellers1h` number, nullable
          - `organicSellers4h` number, nullable
          - `organicSellers6h` number, nullable
          - `organicSellers12h` number, nullable
          - `organicSellers24h` number, nullable
          - `createdAt` string, nullable, required
          - `latestTradeDate` string, nullable, required
          - `holdersCount` number, nullable
          - `description` string, nullable, required
          - `socials` object, required
            - `twitter` string, nullable, required
            - `website` string, nullable, required
            - `telegram` string, nullable, required
            - `others` object, nullable, required
            - `uri` string
          - `security` object, nullable, required
            - `buyTax` string, nullable
            - `sellTax` string, nullable
            - `transferPausable` boolean
            - `top10Holders` string
            - `isBlacklisted` boolean
            - `noMintAuthority` boolean
            - `balanceMutable` boolean
            - `lowLiquidity` string
            - `burnRate` string
            - `liquidityBurnPercentage` number
            - `isHoneypot` boolean
            - `isNotOpenSource` boolean
            - `renounced` boolean
            - `locked` string
            - `isWhitelisted` boolean
            - `isMintable` boolean
            - `modifyableTax` boolean
            - `selfDestruct` boolean
          - `twitterReusesCount` number, nullable
          - `twitterRenameCount` number, nullable
          - `twitterRenameHistory` object[]
            - `username` string, required
            - `lastChecked` string, required
          - `deployerMigrationsCount` number, nullable
          - `deployerTokensCount` number, nullable
          - `securityScore` number, nullable
          - `securityScoreUpdatedAt` string, nullable
          - `dexscreenerListed` boolean, nullable
          - `dexscreenerHeader` string, nullable
          - `dexscreenerAdPaid` boolean, nullable
          - `dexscreenerAdPaidDate` string, nullable
          - `dexscreenerPendingAt` string, nullable
          - `dexscreenerSocialPaid` boolean, nullable
          - `dexscreenerSocialPaidDate` string, nullable
          - `liveStatus` string, nullable, required
          - `liveThumbnail` string, nullable, required
          - `livestreamTitle` string, nullable, required
          - `liveReplyCount` number, nullable, required
          - `dexscreenerBoosted` boolean, nullable
          - `dexscreenerBoostedDate` string, nullable
          - `dexscreenerBoostedAmount` number, nullable
          - `isMayhemMode` boolean, nullable
          - `isCashbackCoin` boolean, nullable
          - `isAgentMode` boolean, nullable
          - `isOGCoin` boolean, nullable
          - `top10HoldingsPercentage` number, nullable
          - `top50HoldingsPercentage` number, nullable
          - `top100HoldingsPercentage` number, nullable
          - `top200HoldingsPercentage` number, nullable
          - `devHoldingsPercentage` number, nullable
          - `insidersHoldingsPercentage` number, nullable
          - `bundlersHoldingsPercentage` number, nullable
          - `snipersHoldingsPercentage` number, nullable
          - `proTradersHoldingsPercentage` number, nullable
          - `freshTradersHoldingsPercentage` number, nullable
          - `smartTradersHoldingsPercentage` number, nullable
          - `insidersCount` number, nullable
          - `bundlersCount` number, nullable
          - `snipersCount` number, nullable
          - `freshTradersCount` number, nullable
          - `proTradersCount` number, nullable
          - `smartTradersCount` number, nullable
          - `freshTradersBuys` number, nullable
          - `proTradersBuys` number, nullable
          - `smartTradersBuys` number, nullable
        - `wallet` string, required
      - object
        - `wallet` string, required
        - `error` string, required
  - `hostname` string

## Other responses

- `402` — Payment Required

---

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