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>",
      "operation": "<string>",
      "type": "<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>"
      ],
      "labels": [],
      "walletMetadata": {
        "entityName": "<string>",
        "entityLogo": "<string>",
        "entityLabels": [
          "<string>"
        ],
        "entityType": "<string>",
        "entityDescription": "<string>",
        "entityTwitter": "<string>",
        "entityWebsite": "<string>",
        "entityGithub": "<string>",
        "entityDiscord": "<string>",
        "entityTelegram": "<string>"
      },
      "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
walletsstring-Comma-separated list of additional wallet addresses
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
The endpoint also supports POST requests with the same parameters in the JSON body. Useful for complex queries or when passing multiple wallet addresses.

​
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"

​
POST with multiple wallets

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

​
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"

​
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

​
blockchains
string

Comma-separated list of blockchain IDs (e.g., "ethereum,base,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