Get Wallet Trades

Retrieve swap trades for a single wallet (GET or flat POST), or for multiple wallets in one batch request (POST), with pagination, token filtering, and enriched base/quote metadata.

GET /2/wallet/trades

Get wallet trades

cURL

curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/trades

200

{
  "data": [
    {
      "id": "<string>",
      "baseTokenAmount": 123,
      "baseTokenAmountRaw": "<string>",
      "baseTokenAmountUSD": 123,
      "quoteTokenAmount": 123,
      "quoteTokenAmountRaw": "<string>",
      "quoteTokenAmountUSD": 123,
      "date": 123,
      "swapSenderAddress": "<string>",
      "transactionSenderAddress": "<string>",
      "blockchain": "<string>",
      "transactionHash": "<string>",
      "marketAddress": "<string>",
      "baseTokenPriceUSD": 123,
      "quoteTokenPriceUSD": 123,
      "preBalanceBaseToken": "<string>",
      "preBalanceQuoteToken": "<string>",
      "postBalanceBaseToken": "<string>",
      "postBalanceQuoteToken": "<string>",
      "swapRecipient": "<string>",
      "marketAddresses": [
        "<string>"
      ],
      "baseTokenMarketCapUSD": 123,
      "quoteTokenMarketCapUSD": 123,
      "labels": [],
      "walletMetadata": {
        "entityName": "<string>",
        "entityLogo": "<string>",
        "entityLabels": [
          "<string>"
        ],
        "entityType": "<string>",
        "entityDescription": "<string>",
        "entityTwitter": "<string>",
        "entityWebsite": "<string>",
        "entityGithub": "<string>",
        "entityDiscord": "<string>",
        "entityTelegram": "<string>",
        "extra": {}
      },
      "baseToken": {
        "address": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "logo": "<string>",
        "decimals": 123
      },
      "quoteToken": {
        "address": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "logo": "<string>",
        "decimals": 123
      },
      "platform": {
        "id": "<string>",
        "name": "<string>",
        "logo": "<string>"
      },
      "totalFeesUSD": 123,
      "gasFeesUSD": 123,
      "platformFeesUSD": 123,
      "mevFeesUSD": 123
    }
  ],
  "pagination": {
    "page": 123,
    "offset": 123,
    "limit": 123,
    "pageEntries": 123
  }
}

Query Parameters

wallet · string · required

Wallet address

tokenAddress · string

Filter trades involving this token contract address

chainIds · string

Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.

limit · number

Number of trades per page (1-100, default: 50)

Required range: 1 <= x <= 100

offset · number | null

Offset for pagination (default: 0)

Required range: x >= 0

order · enum<string>

Sort order: asc or desc (default: desc)

Available options: asc, desc

from · number | null

Start timestamp in milliseconds

to · number | null

End timestamp in milliseconds

Response

200 - application/json

Wallet trades response

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes