Get Wallet Trades

Get wallet trades

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

import requests

url = "https://demo-api.mobula.io/api/2/wallet/trades"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://demo-api.mobula.io/api/2/wallet/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://demo-api.mobula.io/api/2/wallet/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://demo-api.mobula.io/api/2/wallet/trades"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://demo-api.mobula.io/api/2/wallet/trades")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://demo-api.mobula.io/api/2/wallet/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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
  }
}

GET

wallet

trades

Get wallet trades

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

import requests

url = "https://demo-api.mobula.io/api/2/wallet/trades"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://demo-api.mobula.io/api/2/wallet/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://demo-api.mobula.io/api/2/wallet/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://demo-api.mobula.io/api/2/wallet/trades"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://demo-api.mobula.io/api/2/wallet/trades")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://demo-api.mobula.io/api/2/wallet/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

Parameter	Type	Default	Description
`tokenAddress`	string	-	Filter trades involving this token contract address
`blockchains`	string	-	Comma-separated list of blockchain IDs (e.g., `"ethereum,base,solana:solana"`)
`limit`	number	50	Number of trades per page (min: 1, max: 100)
`offset`	number	0	Offset for pagination
`order`	string	”desc”	Sort order by date: `"asc"` or `"desc"`
`from`	number	-	Start timestamp in milliseconds
`to`	number	-	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:

Field	Type	Description
`id`	string	Unique trade identifier
`type`	string	Trade direction: `"buy"` or `"sell"` (relative to base token)
`operation`	string	Swap type: `"regular"`, `"mev"`, etc.
`baseTokenAmount`	number	Amount of base token traded (formatted with decimals)
`baseTokenAmountRaw`	string	Raw amount of base token in smallest units
`baseTokenAmountUSD`	number	USD value of the trade
`quoteTokenAmount`	number	Amount of quote token traded (formatted)
`quoteTokenAmountRaw`	string	Raw amount of quote token in smallest units
`quoteTokenAmountUSD`	number	USD value of the quote side
`baseTokenPriceUSD`	number	Base token price at trade time
`quoteTokenPriceUSD`	number	Quote token price at trade time
`date`	number	Trade timestamp in milliseconds
`blockchain`	string	Blockchain name (e.g., `"Ethereum"`, `"Solana"`)
`transactionHash`	string	Transaction hash
`marketAddress`	string	Pool/market contract address
`transactionSenderAddress`	string	Wallet that sent the transaction
`swapSenderAddress`	string	Address that initiated the swap (may differ for AA wallets)
`swapRecipient`	string\|null	Swap beneficiary address (important for Account Abstraction)
`baseToken`	object\|null	`{ address, name, symbol, logo, decimals }`
`quoteToken`	object\|null	`{ address, name, symbol, logo, decimals }`
`labels`	string[]	Wallet labels (e.g., `"sniper"`, `"insider"`, `"smart-money"`)
`platform`	object\|null	`{ id, name, logo }` - Trading platform/aggregator
`totalFeesUSD`	number\|null	Total fees paid in USD
`gasFeesUSD`	number\|null	Gas fees in USD
`platformFeesUSD`	number\|null	Platform/aggregator fees in USD
`mevFeesUSD`	number\|null	MEV/priority fees in USD
`preBalanceBaseToken`	string\|null	Pre-swap raw balance of base token
`preBalanceQuoteToken`	string\|null	Pre-swap raw balance of quote token
`postBalanceBaseToken`	string\|null	Post-swap raw balance of base token
`postBalanceQuoteToken`	string\|null	Post-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 field	Type	Default	Description
`wallet`	string	-	Required. Wallet address (EVM or Solana)
`tokenAddress`	string	-	Filter trades involving this token contract address
`chainIds`	string[]	-	Array of chain IDs (e.g., `["evm:1","evm:8453"]`). All chains if omitted
`limit`	number	50	Number of trades per page (min: 1, max: 100)
`offset`	number	0	Offset for pagination
`order`	string	”desc”	Sort order by date: `"asc"` or `"desc"`
`from`	number	-	Start timestamp in milliseconds
`to`	number	-	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

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

Get Wallet DeFi Positions Get Wallet Deployer Tokens

⌘I

Introduction

Market & Token Data

History - Prices & OHLCV Candles

Trades Data

Holders Data

Pulse API

Wallet APIs

Usage Data

Internal

Metacore

Webhook

Perps Data

Misc

Query Details

Required Parameters

Optional Parameters

Step-by-Step Tutorial and Video Walkthrough

Response Overview

Usage Examples

Basic: single wallet

Solana wallet with limit

Filter by token and blockchains

Date range filter

POST body request (single wallet)

Batch requests (multiple wallets)

Sample Response

Query Parameters

Response

​Query Details

​Required Parameters

​Optional Parameters

​Step-by-Step Tutorial and Video Walkthrough

​Pagination

​Response Overview

​Usage Examples

​Basic: single wallet

​Solana wallet with limit

​Filter by token and blockchains

​Pagination with offset

​Date range filter

​POST body request (single wallet)

​Batch requests (multiple wallets)

​Sample Response

Query Parameters

Response

Query Details

Required Parameters

Optional Parameters

Step-by-Step Tutorial and Video Walkthrough

Pagination

Response Overview

Usage Examples

Basic: single wallet

Solana wallet with limit

Filter by token and blockchains

Pagination with offset

Date range filter

POST body request (single wallet)

Batch requests (multiple wallets)

Sample Response