Skip to main content
GET
/
2
/
wallet
/
trades
Get wallet trades
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/trades
{
  "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 Details

​
Required Parameters

  • wallet - Wallet address to query trades for (supports EVM and Solana addresses)

​
Optional Parameters

ParameterTypeDefaultDescription
tokenAddressstring-Filter trades involving this token contract address
blockchainsstring-Comma-separated list of blockchain IDs (e.g., "ethereum,base,solana:solana")
limitnumber50Number of trades per page (min: 1, max: 100)
offsetnumber0Offset for pagination
orderstring”desc”Sort order by date: "asc" or "desc"
fromnumber-Start timestamp in milliseconds
tonumber-End timestamp in milliseconds
POST /2/wallet/trades accepts the same flat wallet body as GET query params. To fetch trades for multiple wallets in one call, use the batch array or items body (see Batch requests below).

​
Step-by-Step Tutorial and Video Walkthrough

  • Check out the guide: Here

​
Pagination

Pagination is offset-based, consistent with other V2 wallet endpoints (/wallet/activity, /wallet/positions).
  • Use offset and limit to control which slice of results you receive
  • page in the response is computed as Math.floor(offset / limit) + 1
The response includes a pagination object: 
{
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 50,
    "pageEntries": 42
  }
}
pageEntries indicates the actual number of trades returned (may be less than limit on the last page).

​
Response Overview

Each item in data[] represents a consolidated swap trade:
FieldTypeDescription
idstringUnique trade identifier
typestringTrade direction: "buy" or "sell" (relative to base token)
operationstringSwap type: "regular", "mev", etc.
baseTokenAmountnumberAmount of base token traded (formatted with decimals)
baseTokenAmountRawstringRaw amount of base token in smallest units
baseTokenAmountUSDnumberUSD value of the trade
quoteTokenAmountnumberAmount of quote token traded (formatted)
quoteTokenAmountRawstringRaw amount of quote token in smallest units
quoteTokenAmountUSDnumberUSD value of the quote side
baseTokenPriceUSDnumberBase token price at trade time
quoteTokenPriceUSDnumberQuote token price at trade time
datenumberTrade timestamp in milliseconds
blockchainstringBlockchain name (e.g., "Ethereum", "Solana")
transactionHashstringTransaction hash
marketAddressstringPool/market contract address
transactionSenderAddressstringWallet that sent the transaction
swapSenderAddressstringAddress that initiated the swap (may differ for AA wallets)
swapRecipientstring|nullSwap beneficiary address (important for Account Abstraction)
baseTokenobject|null{ address, name, symbol, logo, decimals }
quoteTokenobject|null{ address, name, symbol, logo, decimals }
labelsstring[]Wallet labels (e.g., "sniper", "insider", "smart-money")
platformobject|null{ id, name, logo } - Trading platform/aggregator
totalFeesUSDnumber|nullTotal fees paid in USD
gasFeesUSDnumber|nullGas fees in USD
platformFeesUSDnumber|nullPlatform/aggregator fees in USD
mevFeesUSDnumber|nullMEV/priority fees in USD
preBalanceBaseTokenstring|nullPre-swap raw balance of base token
preBalanceQuoteTokenstring|nullPre-swap raw balance of quote token
postBalanceBaseTokenstring|nullPost-swap raw balance of base token
postBalanceQuoteTokenstring|nullPost-swap raw balance of quote token

​
Usage Examples

​
Basic: single wallet

curl -X GET "https://api.mobula.io/api/2/wallet/trades?wallet=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43" \
  -H "Authorization: YOUR_API_KEY"

​
Solana wallet with limit

curl -X GET "https://api.mobula.io/api/2/wallet/trades?wallet=4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ&limit=10" \
  -H "Authorization: YOUR_API_KEY"

​
Filter by token and blockchains

curl -X GET "https://api.mobula.io/api/2/wallet/trades?wallet=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43&tokenAddress=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&blockchains=ethereum&limit=20" \
  -H "Authorization: YOUR_API_KEY"

​
Pagination with offset

curl -X GET "https://api.mobula.io/api/2/wallet/trades?wallet=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43&limit=10&offset=10&order=desc" \
  -H "Authorization: YOUR_API_KEY"

​
Date range filter

curl -X GET "https://api.mobula.io/api/2/wallet/trades?wallet=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43&from=1704067200000&to=1735689600000&order=asc" \
  -H "Authorization: YOUR_API_KEY"

​
POST body request (single wallet)

curl -X POST "https://api.mobula.io/api/2/wallet/trades" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "wallet": "4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ", "limit": 5 }'

​
Batch requests (multiple wallets)

To fetch trades for several wallets in a single call, send a POST to /2/wallet/trades with a JSON array of items (or an object with an items array). Each item targets one wallet and accepts the same filters as the GET query (tokenAddress, chainIds, limit, offset, order, from, to).
  • Maximum 10 wallets per request.
  • Each wallet is processed independently: if one wallet fails, the others still return — that wallet’s entry contains an error field instead of data.
Item fieldTypeDefaultDescription
walletstring-Required. Wallet address (EVM or Solana)
tokenAddressstring-Filter trades involving this token contract address
chainIdsstring[]-Array of chain IDs (e.g., ["evm:1","evm:8453"]). All chains if omitted
limitnumber50Number of trades per page (min: 1, max: 100)
offsetnumber0Offset for pagination
orderstring”desc”Sort order by date: "asc" or "desc"
fromnumber-Start timestamp in milliseconds
tonumber-End timestamp in milliseconds
curl -X POST "https://api.mobula.io/api/2/wallet/trades" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    { "wallet": "0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43", "limit": 20 },
    { "wallet": "4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ", "chainIds": ["solana:solana"], "limit": 10 }
  ]'
The batch response wraps a per-wallet payload array: 
{
  "payload": [
    {
      "wallet": "0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43",
      "data": [ /* trades, same shape as the GET response */ ],
      "pagination": { "page": 1, "offset": 0, "limit": 20, "pageEntries": 20 }
    },
    {
      "wallet": "4tqMHgB8jjbTgefVfqtVFYzyfQz2LQ8T3E922ePmt6kZ",
      "data": [ /* … */ ],
      "pagination": { "page": 1, "offset": 0, "limit": 10, "pageEntries": 10 }
    }
  ],
  "hostname": "…"
}

​
Sample Response

{
  "data": [
    {
      "id": "22039719729",
      "operation": "regular",
      "type": "sell",
      "baseTokenAmount": 10289426.248783976,
      "baseTokenAmountRaw": "10289426248783975872330870",
      "baseTokenAmountUSD": 1953.59,
      "quoteTokenAmount": 0.6675364467,
      "quoteTokenAmountRaw": "667536446729330304",
      "quoteTokenAmountUSD": 1953.59,
      "preBalanceBaseToken": null,
      "preBalanceQuoteToken": null,
      "postBalanceBaseToken": null,
      "postBalanceQuoteToken": null,
      "date": 1768290275000,
      "swapSenderAddress": "0xd2b37ade14708bf18904047b1e31f8166d39612b",
      "transactionSenderAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "swapRecipient": "0xd2b37ade14708bf18904047b1e31f8166d39612b",
      "blockchain": "Ethereum",
      "transactionHash": "0x07dcb584b301f2b8d445e504ff64f27ea8d8a9c9d58329145a0813c9d0f18dd0",
      "marketAddress": "0x79786aa97633871f4ea737b3099cf911598d65b7",
      "baseTokenPriceUSD": 0.00018986,
      "quoteTokenPriceUSD": 3124.15,
      "labels": [],
      "baseToken": {
        "address": "0x9f277edfc463ebaa3d2a6274b01177697e910391",
        "name": "Miniature Woolly Mammoth",
        "symbol": "WOOLLY",
        "logo": "https://metadata.mobula.io/assets/logos/evm_1_0x9f277edfc463ebaa3d2a6274b01177697e910391.webp",
        "decimals": 18
      },
      "quoteToken": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Ethereum",
        "symbol": "ETH",
        "logo": "https://metadata.mobula.io/assets/logos/evm_1_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.webp",
        "decimals": 18
      },
      "platform": null,
      "totalFeesUSD": 0.058,
      "gasFeesUSD": 0.058,
      "platformFeesUSD": 0,
      "mevFeesUSD": 0
    }
  ],
  "pagination": {
    "page": 1,
    "offset": 0,
    "limit": 50,
    "pageEntries": 1
  }
}
The tokenAddress filter uses the raw contract address. Make sure to pass the correct address for the blockchain you’re querying (e.g., WETH on Ethereum, SOL on Solana).
Use order=asc with from to efficiently scan trade history forward from a specific point in time.

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
​
pagination
object
required